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

Consulte también

PHONEBUTTONINFO

PHONE_REPLY

Funciones complementarias del servicio telefónico

Introducción a la referencia de TAPI 2.2