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を返す場合にのみ意味があります。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
操作に成功しました。 |
|
データ クラスは使用できません。 モバイル ブロードバンド サービスは現在、デバイスの情報をプローブしています。 データ クラスが使用可能になると、モバイル ブロードバンド サービスは IMbnRegistrationEvents の OnPacketServiceStateChange メソッドを呼び出します。 |
|
データ クラスを取得するには、PIN が必要です。 |
注釈
GetAvailableDataClasses は、 現在のネットワークで使用可能なデータ クラスのセットを返します。 これらの値は、値が不明な場合 はMBN_DATA_CLASS_NONE に設定できます。
使用可能なデータ クラスは、デバイスが 1 つのセルから別のセルに移動すると、自動的に変更できます。 このような変更が発生するたびに、モバイル ブロードバンド サービスは、IMbnRegistrationEvents の OnPacketServiceStateChange メソッドを呼び出すことによってアプリケーションに通知します。
回復可能なエラー E_MBN_PIN_REQUIREDの場合、モバイル ブロードバンド サービスは、エラー状態が過ぎたとき (PIN が入力されたときに) デバイスからこの情報のフェッチを再試行します。 その後、モバイル ブロードバンド サービスは IMbnRegistrationEvents の OnPacketServiceStateChange メソッドを呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | mbnapi.h |