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) 键。