Platform SDK: TAPI

TSPI_lineGetCallIDs

The TSPI_lineGetCallIDs function returns the call identifiers for the service provider. This function requires TAPI 3.0 version negotiation.

LONG TSPIAPI TSPI_lineGetCallIDs(
  HDRVCALL hdCall,
  LPDWORD lpdwAddressID,
  LPDWORD lpdwCallID,
  LPDWORD lpdwRelatedCallID
);

Parameters

hdCall
The service provider's handle to the call whose identifier is needed.
lpdwAddressID
A pointer to the call's address identifier.
lpdwCallID
A pointer to the call's identifier.
lpdwRelatedCallID
A pointer to the identifier of a related call.

Return Values

Returns zero if the function succeeds, or an error number if an error occurs. Possible return values are as follows:

LINEERR_INVALCALLHANDLE
LINEERR_NOMEM
LINEERR_OPERATIONFAILED
LINEERR_OPERATIONUNAVAIL
LINEERR_RESOURCEUNAVAIL

Remarks

In some telephony environments, the switch or service provider can assign a unique identifier to each call. This allows the call to be tracked across transfers, forwards, or other events. The domain of these call identifiers and their scope is service-provider defined.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Unsupported.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tspi.h.

See Also

CallHub Tracking, LINECALLHUBTRACKINGINFO