次の方法で共有

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