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

重要

バージョン 1803 Windows 10以降、このセクションで説明する 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 メソッドを呼び出します。

要件

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

こちらもご覧ください

IMbnRegistration