ITPhone::get_ButtonMode メソッド (tapi3if.h)

get_ButtonMode メソッドは、特定のボタンに関連付けられているボタンモードを取得します。

このメソッドを呼び出す前に、アプリケーションで ITPhone::Open を呼び出す必要があります。それ以外の場合、呼び出しは失敗します。

構文

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

[in] lButtonID

ボタン識別子。詳細については、「解説」を参照してください。

[out] pButtonMode

ボタンのモードの PHONE_BUTTON_MODE 記述子。

このメソッドは、成功すると S_OK を返します。そうでない場合は、HRESULT エラーコードを返します。

PHONE_BUTTON_MODE列挙型と TAPI 2 の説明を参照してください。ボタンモードの詳細については、x ドキュメントを参照してください。

次の 2 つの PHONE_BUTTON_MODE 値が特に重要です。

PHONE_BUTTON_MODE値がPBM_FEATURE場合、アプリケーションは get_ButtonFunction を呼び出してボタンの特定の意味を取得する必要があります。
PHONE_BUTTON_MODE値がPBM_KEYPAD場合、ボタンはキーパッドボタンであり、その値は lButtonID パラメーターの値で示されます。たとえば、lButtonID == 10 の場合、ボタンはキーパッドの * (star) キーです。