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.
| HLINE hLine,
| DWORD dwAddressID,
| DWORD dwSelect,
| LPLINECALLLIST lpCallList
A handle to an open line device.
An address on the given open line device.
The selection of calls that are requested. Note that dwSelect
can only have one bit set. This parameter uses the following LINECALLSELECT_
Selects calls on the specified line device. The hLine
parameter must be a valid line handle; dwAddressID
Selects calls on the specified address on the specified line device. Both hLine
must be valid.
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.
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.
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
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.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages