Edit

Share via

TSPI_lineGetNumAddressIDs function (tspi.h)

  • Article

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

Syntax

LONG TSPIAPI TSPI_lineGetNumAddressIDs(
  HDRVLINE hdLine,
  LPDWORD  lpdwNumAddressIDs
);

Parameters

hdLine

The handle to the line for which the number of address identifiers is to be retrieved.

lpdwNumAddressIDs

A 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. Possible return values are as follows:

LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_OPERATIONUNAVAIL, LINEERR_RESOURCEUNAVAIL.

Remarks

This function is called by TAPI in response to an application calling lineSetNumRings, lineGetNumRings, or lineGetNewCalls. TAPI uses the retrieved value to determine if the specified address identifier is within the range supported by the service provider.

Requirements

Requirement Value
Target Platform Windows
Header tspi.h

See also

lineGetNewCalls

lineGetNumRings

lineSetNumRings