phoneGetStatusMessages 函式 (tapi.h)

phoneGetStatusMessages 函式會傳回指定電話裝置上的手機狀態變更，產生應用程式的回呼。

語法

LONG phoneGetStatusMessages(
  HPHONE  hPhone,
  LPDWORD lpdwPhoneStates,
  LPDWORD lpdwButtonModes,
  LPDWORD lpdwButtonStates
);

hPhone

要監視的開啟電話裝置的句柄。

lpdwPhoneStates

DWORD 的指標，其中包含零個或多個PHONESTATE_常數。這些旗標會指定應用程式可以接收通知訊息的一組電話狀態變更和事件。您可以個別啟用和停用監視。

lpdwButtonModes

DWORD 的指標，其中包含旗標，指定應用程式可接收通知訊息的一組手機按鈕模式。此參數會使用零、一或多個 PHONEBUTTONMODE_常數。

lpdwButtonStates

包含旗標的 DWORD 指標，指定應用程式可接收通知訊息的一組手機按鈕狀態變更。此參數會使用零、一或多個 PHONEBUTTONSTATE_常數。

如果要求成功或發生錯誤，則傳回零。可能的傳回值為：

PHONEERR_INVALPHONEHANDLE、PHONEERR_NOMEM、PHONEERR_INVALPOINTER、PHONEERR_RESOURCEUNAVAIL、PHONEERR_OPERATIONFAILED、PHONEERR_UNINITIALIZED。

應用程式可以使用 phoneGetStatusMessages 來查詢對應訊息的產生。訊息產生可由 phoneGetStatusMessages 控制。預設會停用所有電話狀態消息。