Función phoneSetStatusMessages (tapi.h)

Artículo
08/26/2023

La función phoneSetStatusMessages permite a una aplicación supervisar el dispositivo telefónico especificado para los eventos de estado seleccionados.

Sintaxis

LONG phoneSetStatusMessages(
  HPHONE hPhone,
  DWORD  dwPhoneStates,
  DWORD  dwButtonModes,
  DWORD  dwButtonStates
);

Parámetros

hPhone

Controle el dispositivo de teléfono abierto que se va a supervisar.

dwPhoneStates

Conjunto de cambios y eventos de estado de teléfono para los que la aplicación puede recibir mensajes de notificación. Este parámetro puede tener cero, uno o varios de los PHONESTATE_ Constantes.

dwButtonModes

Conjunto de modos de botón telefónico para los que la aplicación puede recibir mensajes de notificación. Este parámetro puede tener cero, uno o varios de los PHONEBUTTONMODE_ Constantes.

dwButtonStates

Conjunto de cambios de estado del botón de teléfono para los que la aplicación puede recibir mensajes de notificación. Si el parámetro dwButtonModes es cero, dwButtonStates se omite. Si dwButtonModes tiene uno o varios bits establecidos, este parámetro también debe tener al menos un conjunto de bits. Este parámetro usa las constantes PHONEBUTTONSTATE_.

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_INVALPHONESTATE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALBUTTONMODE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALBUTTONSTATE, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONUNAVAIL.

Comentarios

Una aplicación puede usar la función phoneSetStatusMessages para habilitar o deshabilitar la generación de los mensajes correspondientes. Todos los mensajes de estado del teléfono están deshabilitados de forma predeterminada.