Función phoneSetButtonInfo (tapi.h)
La función phoneSetButtonInfo establece información sobre el botón especificado en el teléfono especificado.
Sintaxis
LONG phoneSetButtonInfo(
HPHONE hPhone,
DWORD dwButtonLampID,
LPPHONEBUTTONINFO const lpButtonInfo
);
Parámetros
hPhone
Controla el dispositivo telefónico abierto. La aplicación debe ser el propietario del dispositivo telefónico.
dwButtonLampID
Botón en el dispositivo telefónico.
lpButtonInfo
Puntero a una estructura de tamaño variable de tipo PHONEBUTTONINFO. Esta estructura de datos describe el modo, la función y proporciona texto descriptivo adicional sobre el botón.
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_INVALBUTTONLAMPID, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONEHANDLE, PHONEERR_STRUCTURETOOSMALL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.
Requisitos
| Plataforma de destino | Windows |
| Encabezado | tapi.h |
| Library | Tapi32.lib |
| Archivo DLL | Tapi32.dll |