Platform SDK: TAPI

TSPI_lineSetLineDevStatus

The TSPI_lineSetLineDevStatus service provider sets the device status as indicated, sending appropriate LINE_LINEDEVSTATE messages to indicate the new status.

LONG TSPIAPI TSPI_lineSetLineDevStatus(
  DRV_REQUESTID dwRequestID,  
  HDRVLINE hdLine,         
  DWORD dwStatusToChange,  
  DWORD fStatus            
);

Parameters

dwRequestID
Identifier for reporting asynchronous function results.
hdLine
The service provider's handle to the line device.
dwStatusToChange
One or more of the LINEDEVSTATUSFLAGS_ constants.
fStatus
TRUE to turn on the indicated status bit(s), FALSE to turn off.

Return Values

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

LINEERR_INVALLINESTATE, 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_LINEDEVSTATE