TSPI_lineSetCallTreatment

The TSPI_lineSetCallTreatment function service provider stores the indicated dwCallTreatment in LINECALLINFO, and sends a LINE_CALLINFO message to indicate the updated information. If the call is currently in a state where the call treatment is relevant, the new treatment goes into effect at once; otherwise, it goes into effect the next time the call enters a relevant state.

LONG TSPIAPI TSPI_lineSetCallTreatment(
  DRV_REQUESTID dwRequestID,  
  HDRVCALL hdCall,            
  DWORD dwTreatment           
);

Parameters

dwRequestID

Identifier for reporting asynchronous function results.

hdCall

The service provider's handle to the call.

dwTreatment

One of the call treatment identifiers supported on the address on which the call appears.

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