Función phoneGetStatusMessages (tapi.h)

Artículo
03/02/2024

La función phoneGetStatusMessages devuelve qué estado de teléfono cambia en el dispositivo telefónico especificado genera una devolución de llamada a la aplicación.

Sintaxis

LONG phoneGetStatusMessages(
  HPHONE  hPhone,
  LPDWORD lpdwPhoneStates,
  LPDWORD lpdwButtonModes,
  LPDWORD lpdwButtonStates
);

Parámetros

hPhone

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

lpdwPhoneStates

Puntero a un DWORD que contiene cero, una o varias de las constantes de PHONESTATE_. Estas marcas especifican el conjunto de cambios y eventos de estado del teléfono para los que la aplicación puede recibir mensajes de notificación. La supervisión se puede habilitar y deshabilitar individualmente.

lpdwButtonModes

Puntero a un DWORD que contiene marcas que especifican el conjunto de modos de botón de teléfono para los que la aplicación puede recibir mensajes de notificación. Este parámetro usa cero, una o varias de las PHONEBUTTONMODE_ Constantes.

lpdwButtonStates

Puntero a un DWORD que contiene marcas que especifican el conjunto de cambios de estado del botón de teléfono para los que la aplicación puede recibir mensajes de notificación. Este parámetro usa cero, una o varias de las constantes de 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_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONFAILED, PHONEERR_UNINITIALIZED.

Comentarios

Una aplicación puede usar phoneGetStatusMessages para consultar la generación de los mensajes correspondientes. La generación de mensajes se puede controlar mediante phoneGetStatusMessages. Todos los mensajes de estado del teléfono están deshabilitados de forma predeterminada.