IMbnInterface：：GetReadyState 方法 (mbnapi.h)
重要
從 Windows 10 1803 版開始，本節所述的 WIN32 API 會由Windows.Networking.Connectivity命名空間中的 Windows 執行階段 API 取代。
取得就緒狀態。
語法
HRESULT GetReadyState(
[out, retval] MBN_READY_STATE *readyState
);
參數
[out, retval] readyState
MBN_READY_STATE結構的指標。 如果這個方法傳回 S_OK以外的任何值，則此參數為 Null。
傳回值
這個方法可以傳回其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
已成功完成命令。 readyState 包含有效值。 |
|
資訊無法使用。 行動寬頻服務目前正在探查就緒狀態。 呼叫端應用程式可以藉由註冊IMbnInterfaceEvents的OnReadyStateChange方法，在就緒狀態可用時收到通知。 |
備註
就緒狀態會指定介面是否已成功初始化，並準備好執行連線作業。 針對 SIM 型裝置，當裝置已成功初始化 SIM 卡時，裝置便已就緒。 只有在就緒狀態 MBN_READY_STATE_INITIALIZED時，裝置才能用於連線。 如需其他裝置狀態的詳細資訊，請參閱 MBN_READY_STATE。
介面的就緒狀態可能會因為使用者作業而變更。 例如，當使用者將 SIM 卡插入裝置時，就緒狀態會從 MBN_READY_STATE_SIM_NOT_INSERTED 變更為另一個就緒狀態。 就緒狀態也可能因為應用程式執行的其他作業而變更。 例如，輸入 PIN 時，就緒狀態可以從 MBN_READY_STATE_DEVICE_LOCKED 變更為另一個就緒狀態。 每當介面處於就緒狀態變更時，應用程式就可以註冊事件通知。 系統會呼叫IMbnInterfaceEvents的OnReadyStateChange成員，以通知應用程式有關就緒狀態的任何變更。
當裝置回報 MBN_READY_STATE_INITIALIZED時，裝置的 SMS 子系統可能無法就緒。 呼叫的應用程式應該等候呼叫 IMbnSmsEvents的OnSmsConfigurationChange成員，指出 SMS 子系統已就緒。
需求
| 最低支援的用戶端 | Windows 7 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | mbnapi.h |