Função phoneSetStatusMessages (tapi.h)

Artigo
08/26/2023

A função phoneSetStatusMessages permite que um aplicativo monitore o dispositivo de telefone especificado para eventos status selecionados.

Sintaxe

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

Parâmetros

hPhone

Manipule para o dispositivo de telefone aberto a ser monitorado.

dwPhoneStates

Conjunto de status de telefone alterações e eventos para os quais o aplicativo pode receber mensagens de notificação. Esse parâmetro pode ter zero, um ou mais constantes PHONESTATE_.

dwButtonModes

Conjunto de modos de botão de telefone para os quais o aplicativo pode receber mensagens de notificação. Esse parâmetro pode ter zero, um ou mais constantes de PHONEBUTTONMODE_.

dwButtonStates

Conjunto de alterações de estado do botão de telefone para as quais o aplicativo pode receber mensagens de notificação. Se o parâmetro dwButtonModes for zero, dwButtonStates será ignorado. Se dwButtonModes tiver um ou mais bits definidos, esse parâmetro também deverá ter pelo menos um bit definido. Esse parâmetro usa as constantes PHONEBUTTONSTATE_.

Valor retornado

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

Comentários

Um aplicativo pode usar a função phoneSetStatusMessages para habilitar ou desabilitar a geração das mensagens correspondentes. Todas as mensagens de status de telefone são desabilitadas por padrão.