|
lineGetNewCalls
The lineGetNewCalls function returns call handles to calls on a specified line or address for
which the application currently does not have handles. The application is granted
monitor privilege to these calls.
LONG lineGetNewCalls(
HLINE hLine,
|
| DWORD dwAddressID,
|
| DWORD dwSelect,
|
| LPLINECALLLIST lpCallList
|
| );
|
|
Parameters
hLine
A handle to an open line device.
dwAddressID
An address on the given open line device.
dwSelect
The selection of calls that are requested. Note that dwSelect can only have one bit set. This parameter uses the following LINECALLSELECT_
constants:
LINECALLSELECT_LINE
Selects calls on the specified line device. The hLine parameter must be a valid line handle; dwAddressID is ignored.
LINECALLSELECT_ADDRESS
Selects calls on the specified address on the specified line device. Both hLine and dwAddressID must be valid.
lpCallList
A pointer to a variably sized data structure of type LINECALLLIST. Upon successful completion of the request, call handles to all selected
calls are returned in this structure. Prior to calling lineGetNewCalls, the application should set the dwTotalSize field of this structure to indicate the amount of memory available to TAPI
for returning information.
Return Values
Returns zero if the request is successful or a negative error number if an
error has occurred. Possible return values are:
LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT,
LINEERR_RESOURCEUNAVAIL, LINEERR_INVALLINEHANDLE, LINEERR_STRUCTURETOOSMALL,
LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.
Remarks
An application can use lineGetNewCalls to obtain handles to calls for which it currently has no handles. The
application can select the calls for which handles are to be returned by basing this
selection on scope (calls on a specified line, or calls on a specified address).
For example, an application can request call handles to all calls on a given
address for which it currently has no handle. The application is always given
monitor privilege to the new call handles. Also, when opening a line, an
application uses this function to become aware of existing calls.
The application can invoke lineGetCallInfo and lineGetCallStatus for each call in the list to determine the call's information and status,
respectively. It can use lineSetCallPrivilege to change its privilege to owner.
See Also
LINECALLLIST, lineGetCallInfo, lineGetCallStatus, lineSetCallPrivilege
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
More Online Helps
Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Unix Manual Pages
|
