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

重要

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

デバイスの登録モードを設定します。

構文

HRESULT SetRegisterMode(
  [in]  MBN_REGISTER_MODE registerMode,
  [in]  LPCWSTR           providerID,
  [in]  ULONG             dataClass,
  [out] ULONG             *requestID
);

パラメーター

[in] registerMode

新しい登録モードを指定する MBN_REGISTER_MODE 値。

[in] providerID

登録するネットワーク プロバイダーのプロバイダー ID を指定する文字列。 registerMode がMBN_REGISTER_MODE_AUTOMATIC場合は NULL にする必要があります。

[in] dataClass

接続に推奨されるデータ アクセス テクノロジを指定する OR MBN_DATA_CLASS 値のビットごとの組み合わせ。 モバイル ブロードバンド サービスは、この一覧から利用可能な最高のデータ クラス テクノロジを登録します。 このリストのデータ クラスを登録できない場合は、モバイル ブロードバンド サービスが使用可能な最適なデータ クラスに登録されます。

[out] requestID

この非同期要求を識別するためにモバイル ブロードバンド サービスによって設定された要求 ID。

戻り値

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

リターン コード	説明
S_OK	メソッドは正常に完了しました。
HRESULT_FROM_WIN32(ERROR_SERVICE_NOT_ACTIVE)	モバイル ブロードバンド サービスがこのシステムで実行されていません。
E_HANDLE	モバイル ブロードバンド デバイスがシステムから削除されているため、インターフェイスは無効です。
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)	インターフェイスが無効です。 ほとんどの場合、モバイル ブロードバンド デバイスがシステムから削除されています。
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	アクティブなネットワーク接続が既にあります。 登録モードは、既に確立されているデータ接続がある間は変更できません。 呼び出し元のアプリケーションは、最初に接続を切断してから、登録モードの変更を試みる必要があります。 デバイスが既に要求モードで、要求されたプロバイダーに接続されている場合、リターン コードは S_OKされます。

解説

SetRegisterMode メソッドを使用すると、デバイスを自動または手動のネットワーク選択モードに設定できます。 手動登録モードの場合、デバイスを登録する必要があるネットワーク ID は providerID で指定されます。

手動登録モードのサポートは省略可能であり、アプリケーションは、IMbnInterface の GetInterfaceCapability メソッドによって入力された interfaceCaps パラメーターでMBN_CTRL_CAPS_REG_MANUALを確認することで、デバイスが手動登録をサポートしていることを確認する必要があります。 アプリケーションが手動登録モードを設定し、デバイスでサポートされていない場合、この呼び出しは HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)を返します。

SetRegisterMode は非同期であり、すぐにを返します。 エラーが発生しない場合、操作の完了時に、モバイル ブロードバンド サービスは IMbnRegistrationEvents の OnSetRegisterModeComplete メソッドを呼び出します。

要件

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

関連項目

IMbnRegistration