Compartilhar via


Função phoneGetStatus (tapi.h)

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

Sintaxe

LONG phoneGetStatus(
  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 variável do tipo PHONESTATUS, que é carregada com as informações retornadas sobre o status do telefone.

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

Comentários

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

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi.h
Biblioteca Tapi32.lib
DLL Tapi32.dll

Confira também

PHONESTATUS

Funções de serviço de telefonia suplementar

Visão geral da referência do TAPI 2.2