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以外的任何專案,則不會設定此指標的內容。
傳回值
這個方法可以傳回其中一個值。
傳回碼 | 描述 |
---|---|
|
已成功完成命令。 |
|
撥號狀態無法使用。 行動寬頻服務正在探查裝置中的資訊。 註冊IMbnConnectionEvents的OnVoiceCallStateChange方法,即可通知呼叫應用程式。 |
|
需要 PIN 才能取得撥號狀態。 |
|
SIM 卡不會插入裝置中。 |
|
在裝置中插入不正確的 SIM 卡。 |
備註
針對可復原的錯誤 E_MBN_PIN_REQUIRED、 E_MBN_SIM_NOT_INSERTED和 E_MBN_BAD_SIM,行動寬頻服務會在錯誤狀況結束之後,重新查詢裝置是否有此資訊。 例如,如果裝置需要輸入 PIN 才能擷取語音通話狀態,則會傳回 E_MBN_PIN_REQUIRED 。 通話應用程式進入 PIN 以解除鎖定裝置之後,行動寬頻服務會再次嘗試從裝置取得語音通話狀態。 行動寬頻服務會呼叫IMbnConnectionEvents的OnVoiceCallStateChange方法,以更新應用程式的狀態。
需求
最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | mbnapi.h |