lineSetLineDevStatus

The lineSetLineDevStatus function sets the line device status. Except for basic parameter validation, it is a straight pass-through to the service provider. The service provider sends a LINE_LINEDEVSTATE message to inform applications of the new state, when set; TAPI does not synthesize these messages.

LONG WINAPI lineSetLineDevStatus(
  HLINE hLine,             
  DWORD dwStatusToChange,  
  DWORD fStatus            
);

Parameters

hLine

Handle to the line device.

dwStatusToChange

One or more of the LINEDEVSTATUSFLAGS_ Constants.

fStatus

TRUE (–1) to turn on the indicated status bit(s), FALSE (0) to turn off.

Return Values

Returns a positive request identifier if the asynchronous operation starts; otherwise, the function returns one of these negative error values:

LINEERR_INVALLINEHANDLE, LINEERR_INVALLINESTATE, LINEERR_INVALPARAM, LINEERR_NOMEM, LINEERR_OPERATIONUNAVAIL, LINEERR_OPERATIONFAILED, LINEERR_RESOURCEUNAVAIL, LINEERR_UNINITIALIZED.

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 Tapi.h.
  Library: Use Tapi32.lib.