共用方式為


IMbnConnection::GetVoiceCallState 方法 (mbnapi.h)

重要

從 Windows 10 1803 版開始,本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。

取得裝置的語音通話狀態。

語法

HRESULT GetVoiceCallState(
  [out, retval] MBN_VOICE_CALL_STATE *voiceCallState
);

參數

[out, retval] voiceCallState

指定語音通話狀態 之MBN_VOICE_CALL_STATE 值的指標。 如果方法傳回 S_OK以外的任何專案,則不會設定此指標的內容。

傳回值

這個方法可以傳回其中一個值。

傳回碼 描述
S_OK
已成功完成命令。
E_PENDING
撥號狀態無法使用。 行動寬頻服務正在探查裝置中的資訊。 註冊IMbnConnectionEventsOnVoiceCallStateChange方法,即可通知呼叫應用程式。
E_MBN_PIN_REQUIRED
需要 PIN 才能取得撥號狀態。
E_MBN_SIM_NOT_INSERTED
SIM 卡不會插入裝置中。
E_MBN_BAD_SIM
在裝置中插入不正確的 SIM 卡。

備註

針對可復原的錯誤 E_MBN_PIN_REQUIREDE_MBN_SIM_NOT_INSERTEDE_MBN_BAD_SIM,行動寬頻服務會在錯誤狀況結束之後,重新查詢裝置是否有此資訊。 例如,如果裝置需要輸入 PIN 才能擷取語音通話狀態,則會傳回 E_MBN_PIN_REQUIRED 。 通話應用程式進入 PIN 以解除鎖定裝置之後,行動寬頻服務會再次嘗試從裝置取得語音通話狀態。 行動寬頻服務會呼叫IMbnConnectionEventsOnVoiceCallStateChange方法,以更新應用程式的狀態。

需求

   
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 mbnapi.h

另請參閱

IMbnConnection