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

Consulte también

Funciones complementarias del servicio telefónico

Información general de referencia de TAPI 2.2