TSPI_lineGetCallAddressID
The TSPI_lineGetCallAddressID function retrieves the address identifier for the indicated call.
LONG TSPIAPI TSPI_lineGetCallAddressID(
HDRVCALL hdCall,
LPDWORD lpdwAddressID );
Parameters
- hdCall
The service provider's handle to the call whose address identifier is to be retrieved. The call state of hdCall can be any state. - lpdwAddressID
A pointer to a DWORD into which the service provider writes the call's address identifier.
Return Values
Returns zero if the function succeeds or an error number if an error occurs. Possible return values are as follows:
LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.
Remarks
If the service provider models lines as "pools" of channel resources and does inverse multiplexing of a call over several address identifiers it should consistently choose one of these address identifiers as the primary identifier reported by this function and in the LINECALLINFO data structure.
This function has no direct correspondence at the TAPI level. It gives TAPI sufficient information to implement the lineGetNewCalls function invoked with the LINECALLSELECT_ADDRESS option.
Requirements
Runs On | Versions | Defined in | Include | Link to |
---|---|---|---|---|
Windows CE OS | 3.0 and later | Tapicomn.h | Coredll.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.