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 檔，以取得按鈕模式的詳細資訊。

下列兩個PHONE_BUTTON_MODE 值特別感興趣：

如果 PHONE_BUTTON_MODE 值PBM_FEATURE，應用程式應該呼叫 get_ButtonFunction 以擷取按鈕的特定意義。
如果 PHONE_BUTTON_MODE 值是PBM_KEYPAD，則按鈕是按鍵按鈕，其值是以 lButtonID 參數的值表示。例如，如果lButtonID == 10，則按鈕是鍵盤上的 * (star) 鍵。