ITPhone::get_ButtonMode, méthode (tapi3if.h)

La méthode get_ButtonMode récupère le mode de bouton associé à un bouton particulier.

L’application doit appeler ITPhone::Open avant d’appeler cette méthode ; sinon, l’appel échoue.

Syntaxe

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

[in] lButtonID

Identificateur de bouton. Pour plus d'informations, consultez la section Notes qui suit.

[out] pButtonMode

Descripteur PHONE_BUTTON_MODE pour le mode du bouton.

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Consultez la description de l’énumération PHONE_BUTTON_MODE et du TAPI 2. x documentation pour plus d’informations sur les modes de bouton.

Les deux valeurs PHONE_BUTTON_MODE suivantes présentent un intérêt particulier :

Si la valeur PHONE_BUTTON_MODE est PBM_FEATURE, l’application doit appeler le get_ButtonFunction pour récupérer la signification spécifique du bouton.
Si la valeur PHONE_BUTTON_MODE est PBM_KEYPAD, le bouton est un bouton de clavier dont la valeur est indiquée par la valeur du paramètre lButtonID . Par exemple, si lButtonID == 10, le bouton est la touche * (star) du pavé numérique.