IMbnConnection：：GetConnectionState 方法 (mbnapi.h)

重要

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

取得裝置的目前線上狀態。

語法

HRESULT GetConnectionState(
  [out, retval] MBN_ACTIVATION_STATE *ConnectionState,
  [out, retval] BSTR                 *ProfileName
);

[out, retval] ConnectionState

包含連接狀態之MBN_ACTI加值稅ION_STATE 結構的指標。

[out, retval] ProfileName

字串的指標，其中包含連接設定檔的名稱。只有當 ConnectionStateMBN_ACTI加值稅ION_STATE_ACTI加值稅ED時，此參數才有效。當此字串不是 Null時，呼叫應用程式必須呼叫 SysFreeString來釋放此字串。

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

傳回碼	描述
S_OK	已成功完成命令。注意當 ProfileName 為 Null時，這個方法可以傳回S_OK。請確定您的用戶端能夠處理 NullProfileName ，即使呼叫成功也一樣。
E_PENDING	啟用狀態無法使用。行動寬頻服務正在探查裝置中的資訊。註冊IMbnConnectionEvents的OnConnectStateChange方法，即可在啟用狀態可用時通知呼叫應用程式。
E_MBN_PIN_REQUIRED	需要 PIN 才能取得撥號狀態。
E_MBN_SIM_NOT_INSERTED	SIM 卡不會插入裝置中。
E_MBN_BAD_SIM	在裝置中插入不正確的 SIM 卡。

當 ProfileName 為 Null時，這個方法可以傳回S_OK。請確定您的用戶端能夠處理 NullProfileName ，即使呼叫成功也一樣。