phoneSetStatusMessages 函式 (tapi.h)
phoneSetStatusMessages 函式可讓應用程式監視所選取狀態事件的指定電話裝置。
語法
LONG phoneSetStatusMessages(
HPHONE hPhone,
DWORD dwPhoneStates,
DWORD dwButtonModes,
DWORD dwButtonStates
);
參數
hPhone
要監視的開啟電話裝置的控制碼。
dwPhoneStates
應用程式可以接收通知訊息的電話狀態變更和事件集。 此參數可以有零、一或多個 PHONESTATE_常數。
dwButtonModes
應用程式可接收通知訊息的一組手機按鈕模式。 此參數可以有零、一或多個 PHONEBUTTONMODE_常數。
dwButtonStates
應用程式可以接收通知訊息的手機按鈕狀態變更集。 如果 dwButtonModes 參數為零， 則會忽略 dwButtonStates 。 如果 dwButtonModes 已設定一或多個位，此參數也必須至少設定一個位。 此參數會使用 PHONEBUTTONSTATE_ 常數。
傳回值
如果要求成功或發生錯誤，則傳回零。 可能的傳回值為：
PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPHONESTATE、PHONEERR_RESOURCEUNAVAIL、PHONEERR_INVALBUTTONMODE、PHONEERR_OPERATIONFAILED、PHONEERR_INVALBUTTONSTATE、PHONEERR_UNINITIALIZED、PHONEERR_OPERATIONUNAVAIL。
備註
應用程式可以使用 phoneSetStatusMessages 函式來啟用或停用產生對應的訊息。 預設會停用所有電話狀態訊息。
規格需求
| 目標平台 | Windows |
| 標頭 | tapi.h |
| 程式庫 | Tapi32.lib |
| Dll | Tapi32.dll |