TSPI_lineSetCallData

The TSPI_lineSetCallData function service provider stores the indicated call data with its information related to the call, and subsequently delivers it whenever TSPI_lineGetCallInfo is called. The service provider sends a LINE_CALLINFO message indicating LINECALLINFOSTATE_CALLDATA to show that the call data has changed. Depending on the service provider implementation, the call data can be propagated to all entities having handles to the call, including those on other machines (through the server), and can travel with the call when it is transferred.

LONG TSPIAPI TSPI_lineSetCallData(
  DRV_REQUESTID dwRequestID,  
  HDRVCALL hdCall,            
  LPVOID lpCallData,          
  DWORD dwSize                
);

Parameters

dwRequestID

Identifier for reporting asynchronous completion information.

hdCall

The service provider's handle to the call.

lpCallData

Address of the data to be copied to the CallData field in LINECALLINFO, replacing any existing data.

dwSize

Number of bytes of data to be copied. A value of 0 causes any existing data to be removed.

Return Values

Returns dwRequestID if the asynchronous operation starts; otherwise, one of these negative error values:

LINEERR_INVALCALLSTATE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONFAILED, LINEERR_RESOURCEUNAVAIL.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 SP3 or later.
  Windows 95/98: Requires Windows 95 or later.
  Version: Requires TAPI 2.0 or later.
  Header: Declared in Tspi.h.

See Also

LINE_CALLINFO, LINECALLINFO, TSPI_lineGetCallInfo