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.
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 lineGetNewCallsfunction. 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

See Also