 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
This function retrieves the address identifier for the indicated call.
Syntax
LONG TSPIAPI TSPI_lineGetCallAddressID( HDRVCALL hdCall, LPDWORD lpdwAddressID ); |
Parameters
- hdCall
-
Service provider's handle to the call whose address identifier is to be retrieved. The call state of hdCallcan be any state.
- lpdwAddressID
-
Pointer to a DWORDinto which the service provider writes the call's address identifier.
Return Value
Returns zero if the function succeeds or an error number if an error occurs. The following table shows the return values for this function.
| Value | Description |
|---|---|
|
LINEERR_NOMEM |
Not enough memory is available. |
|
LINEERR_OPERATIONFAILED |
The operation failed. |
|
LINEERR_OPERATIONUNAVAIL |
The operation is unavailable. |
|
LINEERR_RESOURCEUNAVAIL |
The resource is unavailable. |
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 LINECALLINFOdata structure.
This function has no direct correspondence at the TAPI level. It gives TAPI sufficient information to implement the lineGetNewCallsfunction invoked with the LINECALLSELECT_ADDRESS option.
Requirements
| Header | tapicomn.h |
| Library | coredll.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |