Função phoneSetButtonInfo (tapi.h)

A função phoneSetButtonInfo define informações sobre o botão especificado no telefone especificado.

Sintaxe

LONG phoneSetButtonInfo(
  HPHONE                  hPhone,
  DWORD                   dwButtonLampID,
  LPPHONEBUTTONINFO const lpButtonInfo
);

Parâmetros

hPhone

Identificador para o dispositivo de telefone aberto. O aplicativo deve ser o proprietário do dispositivo de telefone.

dwButtonLampID

Botão no dispositivo do telefone.

lpButtonInfo

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

Valor retornado

Retornará um identificador de solicitação positivo se a função for concluída de forma assíncrona ou um número de erro negativo se ocorrer um erro. O parâmetro dwParam2 da mensagem de PHONE_REPLY correspondente será zero se a função for bem-sucedida ou se for um número de erro negativo se ocorrer um erro. Os valores retornados possíveis são:

PHONEERR_INVALBUTTONLAMPID, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPHONEHANDLE, PHONEERR_STRUCTURETOOSMALL, PHONEERR_INVALPOINTER, PHONEERR_UNINITIALIZED, PHONEERR_NOTOWNER, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_RESOURCEUNAVAIL.