IMbnRegistration::GetAvailableDataClasses メソッド (mbnapi.h)

重要

バージョン 1803 Windows 10以降、このセクションで説明する 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 に設定できます。

使用可能なデータ クラスは、デバイスが 1 つのセルから別のセルに移動すると、自動的に変更できます。 このような変更が発生するたびに、モバイル ブロードバンド サービスは、IMbnRegistrationEvents の OnPacketServiceStateChange メソッドを呼び出すことによってアプリケーションに通知します。

回復可能なエラー E_MBN_PIN_REQUIREDの場合、モバイル ブロードバンド サービスは、エラー状態が過ぎたとき (PIN が入力されたときに) デバイスからこの情報のフェッチを再試行します。 その後、モバイル ブロードバンド サービスは IMbnRegistrationEvents の OnPacketServiceStateChange メソッドを呼び出します。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	mbnapi.h

こちらもご覧ください

IMbnRegistration