Función phoneSetLamp (tapi.h)
La función phoneSetLamp hace que la lámpara especificada se encienda en el dispositivo telefónico abierto especificado en el modo de lámpara especificado.
Sintaxis
LONG phoneSetLamp(
HPHONE hPhone,
DWORD dwButtonLampID,
DWORD dwLampMode
);
Parámetros
hPhone
Controla el dispositivo telefónico abierto. La aplicación debe ser el propietario del teléfono.
dwButtonLampID
Botón cuya lámpara se va a iluminar.
dwLampMode
Cómo se iluminará la lámpara. Este parámetro usa una y solo una de las constantes de PHONELAMPMODE_.
Valor devuelto
Devuelve un identificador de solicitud positivo si la función se completa de forma asincrónica o un número de error negativo si se produce un error. El parámetro dwParam2 del mensaje de PHONE_REPLY correspondiente es cero si la función se ejecuta correctamente o es un número de error negativo si se produce un error. Los valores devueltos posibles son:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_INVALBUTTONLAMPID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPHONESTATE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALLAMPMODE, PHONEERR_UNINITIALIZED.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |