TSPI_lineGetNumAddressIDs

  • Article

This function retrieves the number of address identifiers supported on the indicated line.

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 Values

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

OS Versions: Windows CE 3.0 and later.
Header: Tapicomn.h.
Link Library: Coredll.lib.

See Also

lineGetNewCalls | lineGetNumRings

 Last updated on Saturday, April 10, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.