Compartir a través de


Función phoneGetLamp (tapi.h)

La función phoneGetLamp devuelve el modo de lámpara actual de la lámpara especificada.

Sintaxis

LONG phoneGetLamp(
  HPHONE  hPhone,
  DWORD   dwButtonLampID,
  LPDWORD lpdwLampMode
);

Parámetros

hPhone

Controle el dispositivo de teléfono abierto.

dwButtonLampID

Identificador de la lámpara que se va a consultar.

lpdwLampMode

Puntero a una ubicación de memoria que contiene el estado del modo de lámpara de la lámpara especificada. Este parámetro usa una y solo una de las PHONELAMPMODE_ Constantes.

Valor devuelto

Devuelve cero si la solicitud se realiza correctamente o un número de error negativo si se produce un error. Los valores devueltos posibles son:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALBUTTONLAMPID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Comentarios

Los conjuntos de teléfonos que tienen varias lámparas por botón deben modelarse con varios pares de botón/lámpara. Cada par de botón o lámpara adicional debe usar un botón DUMMY.

Requisitos

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

Consulte también

Funciones complementarias del servicio telefónico

Información general de referencia de TAPI 2.2