重要
バージョン 1803 Windows 10以降、このセクションで説明する Win32 API は、Windows.Networking.Connectivity 名前空間のWindows 运行时 API に置き換えられます。
登録状態を取得します。
構文
HRESULT GetRegisterState(
[out] MBN_REGISTER_STATE *registerState
);
パラメーター
[out] registerState
デバイスの現在の登録状態を指定する MBN_REGISTER_STATE 値を指すポインター。 この値は、メソッドが S_OK返された場合にのみ意味があります。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
操作に成功しました。 |
|
登録状態は使用できません。 モバイル ブロードバンド サービスは現在、デバイスの情報をプローブしています。 登録状態が使用可能になると、モバイル ブロードバンド サービスは IMbnRegistrationEvents の OnRegisterStateChange メソッドを呼び出します。 |
|
登録状態を取得するには、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 |