Función lineSetLineDevStatus (tapi.h)

La función lineSetLineDevStatus establece el estado del dispositivo de línea. Excepto para la validación básica de parámetros, es un paso directo al proveedor de servicios. El proveedor de servicios envía un mensaje LINE_LINEDEVSTATE para informar a las aplicaciones del nuevo estado, cuando se establece; TAPI no sintetiza estos mensajes.

Sintaxis

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

Parámetros

hLine

Identificador del dispositivo de línea.

dwStatusToChange

Una o varias de las constantes de LINEDEVSTATUSFLAGS_.

fStatus

TRUE (–1) para activar los bits de estado indicados, FALSE (0) para desactivarlo.

Valor devuelto

Devuelve un identificador de solicitud positivo si se inicia la operación asincrónica; de lo contrario, la función devuelve uno de estos valores de error negativos:

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

Requisitos

Plataforma de destino	Windows
Encabezado	tapi.h
Library	Tapi32.lib
Archivo DLL	Tapi32.dll