TSPI_lineGetNumAddressIDs
A version of this page is also available for
4/8/2010
This function retrieves the number of address identifiers supported on the indicated line.
Syntax
LONG TSPIAPI TSPI_lineGetNumAddressIDs(
HDRVLINE hdLine,
LPDWORD lpdwNumAddressIDs
);
Parameters
- hdLine
Handle to the line for which the number of address identifiers is to be retrieved.
- lpdwNumAddressIDs
Pointer to a DWORD. The location is filled with the number of address identifiers supported on the indicated line. The value is one or larger.
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
This function is called by TAPI in response to an application calling the lineSetNumRings, lineGetNumRings, or lineGetNewCalls function. TAPI uses the retrieved value to determine if the specified address identifier is within the range supported by the service provider.
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 |