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

  • [アーティクル]

重要

バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows 运行时 API に置き換えられます。

登録状態を取得します。

構文

HRESULT GetRegisterState(
  [out] MBN_REGISTER_STATE *registerState
);

パラメーター

[out] registerState

デバイスの現在の登録状態を指定する MBN_REGISTER_STATE 値を指すポインター。 この値は、メソッドが S_OK返された場合にのみ意味があります。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 操作に成功しました。
E_PENDING
 登録状態は使用できません。 モバイル ブロードバンド サービスは現在、デバイスの情報をプローブしています。 登録状態が使用可能になると、モバイル ブロードバンド サービスは IMbnRegistrationEvents の OnRegisterStateChange メソッドを呼び出します。
E_MBN_PIN_REQUIRED
 登録状態を取得するには、PIN が必要です。

解説

GetRegisterState メソッドは、デバイスの現在のネットワーク登録状態を取得します。 デバイスをネットワークに登録したり、ネットワークで登録を検索したり、登録を拒否したりできます。

デバイスの登録状態は自動的に変更できます。 たとえば、デバイスがネットワーク カバレッジ領域から外れると、登録状態が MBN_REGISTER_STATE_HOME から MBN_REGISTER_STATE_SEARCHING に変更されます。

アプリケーションは、 IMbnRegistrationEvents インターフェイスに接続することで、登録状態変更の更新を受信するために登録できます。 Windows は IMbnRegistrationEvents の OnRegisterStateChange メソッドを呼び出して、これらの変更についてアプリケーションに通知します。

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

要件

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

関連項目

IMbnRegistration