phoneGetStatus 函式 (tapi.h)

phoneGetStatus 函式可讓應用程式查詢指定的開啟手機裝置，以取得其整體狀態。

語法

LONG phoneGetStatus(
  HPHONE        hPhone,
  LPPHONESTATUS lpPhoneStatus
);

參數

hPhone

要查詢的已開啟手機裝置句柄。

lpPhoneStatus

PHONESTATUS 類型的可變大小數據結構的指標，此結構會載入手機狀態的傳回資訊。

傳回值

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

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

備註

應用程式可以使用此函式來判斷已開啟手機裝置的目前狀態。 狀態資訊描述手機裝置的勾點、響鈴、音量、顯示器和照明的相關信息。

規格需求

另請參閱

PHONESTATUS

補充電話服務功能

TAPI 2.2 參考概觀