IMbnRegistration：：GetCurrentDataClass 方法 (mbnapi.h)

重要

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

取得目前網路中目前的數據類別。

語法

HRESULT GetCurrentDataClass(
  [out] ULONG *currentDataClass
);

[out] currentDataClass

MBN_DATA_CLASS值的指標。只有當函式傳回 S_OK時，此參數才有意義。

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

傳回碼	描述
S_OK	作業成功。
E_PENDING	無法使用資料類別。行動寬頻服務目前正在探查裝置以取得資訊。當數據類別可供使用時，行動寬頻服務會呼叫 IMbnRegistrationEvents 的 OnPacketServiceStateChange 方法。
E_MBN_PIN_REQUIRED	需要 PIN 才能取得數據類別。
E_MBN_SIM_NOT_INSERTED	不會在裝置中插入 SIM 卡。
E_MBN_BAD_SIM	在裝置中插入錯誤的 SIM 卡。

GetCurrentDataClass 方法會傳回目前網路中的數據類別。如果值未知，這個值可以設定為 MBN_DATA_CLASS_NONE 。

當裝置從一個行動數據網路移至另一個行動數據網路時，目前的數據類別可以自動變更。每當發生這類變更時，行動寬頻服務會呼叫 IMbnRegistrationEvents 的 OnPacketServiceStateChange 方法來通知應用程式。

針對可復原的錯誤 E_MBN_PIN_REQUIRED，當) 輸入 PIN 時，行動寬頻服務會再次嘗試從裝置擷取這項資訊 (。之後，行動寬頻服務會呼叫 IMbnRegistrationEvents 的 OnPacketServiceStateChange 方法。