Função phoneGetStatusA (tapi.h)

A função phoneGetStatus permite que um aplicativo consulte o dispositivo de telefone aberto especificado quanto ao seu status geral.

Sintaxe

LONG phoneGetStatusA(
  HPHONE        hPhone,
  LPPHONESTATUS lpPhoneStatus
);

Parâmetros

hPhone

Manipule para o dispositivo de telefone aberto a ser consultado.

lpPhoneStatus

Ponteiro para uma estrutura de dados de tamanho variado do tipo PHONESTATUS, que é carregada com as informações retornadas sobre o status do telefone.

Valor de retorno

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_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Observações

Um aplicativo pode usar essa função para determinar o estado atual de um dispositivo de telefone aberto. As informações de status descrevem informações sobre os dispositivos hookswitch do dispositivo de telefone, ringer, volume, exibição e lâmpadas.

Nota

O cabeçalho tapi.h define phoneGetStatus como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
da Plataforma de Destino	Windows
cabeçalho	tapi.h
biblioteca	Tapi32.lib
de DLL	Tapi32.dll

Consulte também

PHONESTATUS

funções de serviço telefônico suplementar

visão geral de referência do TAPI 2.2