IMbnRegistration：：GetAvailableDataClasses 方法 (mbnapi.h)

重要

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

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

語法

HRESULT GetAvailableDataClasses(
  [out] ULONG *availableDataClasses
);

[out] availableDataClasses

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

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

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

GetAvailableDataClasses 會傳回目前網路中可能的數據集。如果值未知，這些值可以設定為 MBN_DATA_CLASS_NONE 。

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

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