Função phoneGetStatusMessages (tapi.h)

Artigo
03/02/2024

A função phoneGetStatusMessages retorna quais alterações de estado de telefone no dispositivo de telefone especificado geram um retorno de chamada para o aplicativo.

Sintaxe

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

Parâmetros

hPhone

Manipule para o dispositivo de telefone aberto a ser monitorado.

lpdwPhoneStates

Ponteiro para um DWORD que contém zero, uma ou mais constantes de PHONESTATE_. Esses sinalizadores especificam o conjunto de status de telefone e eventos para os quais o aplicativo pode receber mensagens de notificação. O monitoramento pode ser habilitado e desabilitado individualmente.

lpdwButtonModes

Ponteiro para um DWORD que contém sinalizadores que especificam o conjunto de modos de botão de telefone para os quais o aplicativo pode receber mensagens de notificação. Esse parâmetro usa zero, uma ou mais das constantes PHONEBUTTONMODE_.

lpdwButtonStates

Ponteiro para um DWORD que contém sinalizadores que especificam o conjunto de alterações de estado do botão do telefone para o qual o aplicativo pode receber mensagens de notificação. Esse parâmetro usa zero, uma ou mais das constantes PHONEBUTTONSTATE_.

Retornar valor

Retornará zero se a solicitação for bem-sucedida ou um número de erro negativo se ocorrer um erro. Os possíveis valores retornados são:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONFAILED, PHONEERR_UNINITIALIZED.

Comentários

Um aplicativo pode usar phoneGetStatusMessages para consultar a geração das mensagens correspondentes. A geração de mensagens pode ser controlada por phoneGetStatusMessages. Todas as mensagens de status de telefone são desabilitadas por padrão.