WlanHostedNetworkInitSettings 関数 (wlanapi.h)

[アーティクル]
08/28/2023

WlanHostedNetworkInitSettings 関数は、これらの設定がまだ構成されていない場合に、ワイヤレスホステッドネットワーク上のネットワーク接続設定 (SSID とピアの最大数など) を構成して保存します。

構文

DWORD WlanHostedNetworkInitSettings(
  [in]            HANDLE                      hClientHandle,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

パラメーター

[in] hClientHandle

WlanOpenHandle 関数の以前の呼び出しによって返されるクライアントのセッションハンドル。

[out, optional] pFailReason

WlanHostedNetworkInitSettings 関数の呼び出しが失敗した場合にエラーの理由を受け取る値への省略可能なポインター。エラーの原因として考えられる値は、Wlanapi.h ヘッダーファイルで定義されているWLAN_HOSTED_NETWORK_REASON列挙の種類です。

pvReserved

将来利用するために予約されています。このパラメーターは NULL である必要があります。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は次のいずれかのリターンコードになります。

リターンコード	説明
ERROR_INVALID_HANDLE	ハンドルが無効です。このエラーは、 hClientHandle パラメーターで指定されたハンドルがハンドルテーブルで見つからなかった場合に返されます。
ERROR_INVALID_PARAMETER	パラメーターが正しくありません。このエラーは、次のいずれかの条件が発生した場合に返されます。 hClientHandle が NULL です。 pvReserved が NULL ではありません。
ERROR_INVALID_STATE	リソースが、要求された操作を実行するための正しい状態ではありません。
ERROR_SERVICE_NOT_ACTIVE	サービスは開始されていません。このエラーは、WLAN AutoConfig サービスが実行されていない場合に返されます。
その他	さまざまな RPC とその他のエラーコード。 FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。

注釈

WlanHostedNetworkInitSettings 関数は、ワイヤレス LAN サービスがインストールされた Windows 7 および Windows Server 2008 R2 のワイヤレスホステッドネットワークをサポートするために追加されたネイティブワイヤレス API の拡張機能です。

クライアントアプリケーションは WlanHostedNetworkInitSettings 関数を呼び出して、ワイヤレスホスト型ネットワークのネットワーク接続設定 (SSID とピアの最大数など) を構成して保存します (接続設定がまだ構成されていない場合)。ワイヤレスホステッドネットワーク設定のネットワーク設定が既に構成されている場合 ( WlanHostedNetworkQueryProperty 関数はステーションプロファイルまたは接続設定の ERROR_BAD_CONFIGURATION を返しません)、この関数呼び出しは、ネットワーク接続設定の構成を変更せずに ERROR_SUCCESS を返します。

クライアントアプリケーションでは、ローカルコンピューターで他のホスト型ネットワーク機能を使用する前 に、必ず WlanHostedNetworkInitSettings 関数を呼び出す必要があります。この関数は、ワイヤレスホスト型ネットワークをローカルコンピューターで初めて使用するときに必要な設定を初期化します。構成が既に永続化されている場合、 WlanHostedNetworkInitSettings 関数は構成を変更しません。そのため、構成が既に永続化されている場合は 、WlanHostedNetworkInitSettings 関数を呼び出しても安全です。 Hosted Network を使用するアプリケーションでは、他の Hosted Network 関数を使用する前 に WlanHostedNetworkInitSettings 関数を呼び出することをお勧めします。

WlanHostedNetworkInitSettings 関数は、ホスト名からランダムで読み取り可能な SSID を計算し、ランダムな主キーを計算します。また、この関数では、を使用して、既定で 100 に設定できるピアの最大数の値を設定します。アプリケーションで別の SSID または異なる最大数のピアを使用する場合、アプリケーションは WlanHostedNetworkSetProperty 関数を呼び出して、ワイヤレスホステッドネットワークで使用されるこれらのプロパティを具体的に設定する必要があります。

呼び出し元のアプリケーションが呼び出しハンドルを閉じる (hClientHandle パラメーターを使用して WlanCloseHandle を呼び出す) 場合、またはプロセスが終了した場合、この関数によって発生した Hosted Network 状態の変更は自動的に元に戻されません。

どのユーザーも WlanHostedNetworkInitSettings 関数を呼び出して、ホスト型ネットワーク上のストレージネットワーク接続設定を構成して永続化できます。ワイヤレスホステッドネットワークが既に構成されている場合、この関数は何も実行せず 、ERROR_SUCCESSを返します。

Windows 7 以降では、ホスト型ネットワーク対応ワイヤレスアダプターがコンピューターに存在する場合、オペレーティングシステムによって仮想デバイスがインストールされます。通常、この仮想デバイスは、コンピューターに 1 つのワイヤレスネットワークアダプターがある場合、"ネットワーク Connections フォルダー" に "ワイヤレスネットワーク接続 2" と表示され、デバイス名は "Microsoft Virtual WiFi ミニポートアダプター" になります。この仮想デバイスは、ソフトウェアアクセスポイント (SoftAP) 接続の実行専用に使用され、 WlanEnumInterfaces 関数によって返されるリストには存在しません。この仮想デバイスの有効期間は、物理ワイヤレスアダプターに関連付けられています。物理ワイヤレスアダプターが無効になっている場合、この仮想デバイスも削除されます。この機能は、ワイヤレス LAN サービスがインストールされている Windows Server 2008 R2 でも使用できます。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	wlanapi.h (Wlanapi.h を含む)
Library	Wlanapi.lib
[DLL]	Wlanapi.dll