Função phoneGetButtonInfoA (tapi.h)

A função phoneGetButtonInfo retorna informações sobre o botão especificado.

Sintaxe

LONG phoneGetButtonInfoA(
  HPHONE            hPhone,
  DWORD             dwButtonLampID,
  LPPHONEBUTTONINFO lpButtonInfo
);

Parâmetros

hPhone

Manipule para o dispositivo de telefone aberto.

dwButtonLampID

Botão no dispositivo de telefone.

lpButtonInfo

Ponteiro para uma estrutura de tamanho variavelmente do tipo PHONEBUTTONINFO . Essa estrutura de dados descreve o modo e a função e fornece texto descritivo adicional correspondente ao botão.

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_INVALBUTTONLAMPID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONESTATE, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED.

Observações

Nota

O cabeçalho tapi.h define phoneGetButtonInfo 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

PHONEBUTTONINFO

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

visão geral de referência do TAPI 2.2