Método ITPhone::get_ButtonMode (tapi3if.h)

O método get_ButtonMode recupera o modo de botão associado a um botão específico.

O aplicativo deve chamar ITPhone::Open antes de invocar esse método; caso contrário, a invocação falhará.

Sintaxe

HRESULT get_ButtonMode(
  [in]  long              lButtonID,
  [out] PHONE_BUTTON_MODE *pButtonMode
);

Parâmetros

[in] lButtonID

Identificador de botão. Para obter mais informações, consulte a seção Comentários a seguir.

[out] pButtonMode

O descritor PHONE_BUTTON_MODE para o modo do botão.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Consulte a descrição da enumeração PHONE_BUTTON_MODE e do TAPI 2. x documentação para obter mais informações sobre modos de botão.

Os dois seguintes valores de PHONE_BUTTON_MODE são de interesse específico:

1. Se o valor PHONE_BUTTON_MODE for PBM_FEATURE, o aplicativo deverá chamar o get_ButtonFunction para recuperar o significado específico do botão.
2. Se o valor PHONE_BUTTON_MODE for PBM_KEYPAD, o botão será um botão de teclado cujo valor é indicado pelo valor do parâmetro lButtonID . Por exemplo, se lButtonID == 10, o botão será a tecla * (star) no teclado.

Requisitos

Confira também

ITPhone

get_ButtonFunction

put_ButtonMode