WlanHostedNetworkSetProperty 関数 (wlanapi.h)

[アーティクル]
03/15/2023

WlanHostedNetworkSetProperty 関数は、ワイヤレスホスト型ネットワークの静的プロパティを設定します。

構文

DWORD WlanHostedNetworkSetProperty(
  [in]            HANDLE                      hClientHandle,
  [in]            WLAN_HOSTED_NETWORK_OPCODE  OpCode,
  [in]            DWORD                       dwDataSize,
  [in]            PVOID                       pvData,
  [out, optional] PWLAN_HOSTED_NETWORK_REASON pFailReason,
                  PVOID                       pvReserved
);

パラメーター

[in] hClientHandle

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

[in] OpCode

設定するプロパティの識別子。この識別子は、Wlanapi.h ヘッダーファイルで定義されているWLAN_HOSTED_NETWORK_OPCODE列挙で次の値のみを指定できます。

wlan_hosted_network_opcode_connection_settings

ホストされているネットワーク接続の設定。

wlan_hosted_network_opcode_enable

ホストされたネットワークが有効なフラグ。

[in] dwDataSize

pvData パラメーターが指すバッファーのサイズをバイト単位で指定する値。

[in] pvData

設定する静的プロパティを持つバッファーへのポインター。このバッファーに関連付けられているデータ型は 、OpCode パラメーターの値によって異なります。

[out, optional] pFailReason

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

pvReserved

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

戻り値

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

関数が失敗した場合、戻り値は次のいずれかの戻りコードになる可能性があります。

リターンコード	説明
ERROR_ACCESS_DENIED	呼び出し元に十分なアクセス許可がありません。このエラーは、 OpCode パラメーターが wlan_hosted_network_opcode_enable され、ワイヤレス Hosted Network がドメインのグループポリシーによって無効になっている場合にも返されます。
ERROR_BAD_PROFILE	ワイヤレスホステッドネットワークで使用されるネットワーク接続プロファイルが破損しています。
ERROR_INVALID_HANDLE	ハンドルが無効です。このエラーは、 hClientHandle パラメーターで指定されたハンドルがハンドルテーブルで見つからなかった場合に返されます。
ERROR_INVALID_PARAMETER	パラメーターが正しくありません。このエラーは、次のいずれかの条件が発生した場合に返されます。 hClientHandle は NULL です。 OpCode は、 WLAN_HOSTED_NETWORK_OPCODEで定義されている列挙値の 1 つではありません。 dwDataSize は 0 です。 pvData は NULL です。 pvData は、整形式の静的プロパティを指していません。 pvReserved が NULL ではありません。
ERROR_INVALID_STATE	リソースが、要求された操作を実行するための正しい状態ではありません。これは、ワイヤレスホストネットワークがシャットダウン中であった場合に発生する可能性があります。
ERROR_NOT_SUPPORTED	要求はサポートされていません。このエラーは、アプリケーションが WlanHostedNetworkSetProperty 関数を呼び出し、 OpCode パラメーターを wlan_hosted_network_opcode_station_profile または wlan_hosted_network_opcode_security_settings に設定した場合に返されます。
ERROR_SERVICE_NOT_ACTIVE	サービスは開始されていません。このエラーは、WLAN AutoConfig サービスが実行されていない場合に返されます。
その他	さまざまな RPC とその他のエラーコード。 FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。

注釈

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

クライアントアプリケーションは WlanHostedNetworkSetProperty 関数を呼び出して、ワイヤレスホステッドネットワークの現在の静的プロパティを設定します。呼び出し元のアプリケーションが呼び出し元のハンドルを閉じる (hClientHandle パラメーターを指定して WlanCloseHandle を呼び出す) 場合、またはプロセスが終了した場合、この関数によって発生した Hosted Network プロパティの変更は自動的に元に戻されません。

pvData パラメーターが指すバッファーに関連付けられているデータ型は、次のように OpCode パラメーターの値によって異なります。

OpCode	説明
wlan_hosted_network_opcode_connection_settings	pvData パラメーターには、WLAN_HOSTED_NETWORK_CONNECTION_SETTINGS構造体へのポインターが渡されます。
wlan_hosted_network_opcode_enable	BOOL へのポインターが pvData パラメーターに渡されます。

OpCode パラメーターを wlan_hosted_network_opcode_enable に設定して WlanHostedNetworkSetProperty 関数を呼び出す場合、ユーザーは適切な関連付けられた特権を持っている必要があります。アクセス許可は、 WLAN_SECURABLE_OBJECTに関連付けられている随意アクセス制御リスト (DACL) に格納されます。 wlan_hosted_network_opcode_enableの OpCode パラメーターを使用して WlanHostedNetworkSetProperty 関数を呼び出すには、呼び出し元のクライアントアクセストークンに、WLAN_SECURABLE_OBJECTの次の列挙によって公開される昇格された特権が必要です。

wlan_secure_hosted_network_elevated_access

WlanHostedNetworkSetProperty 関数が OpCode パラメーターに次のいずれかの値を渡した場合、関数はERROR_NOT_SUPPORTEDで失敗します。

wlan_hosted_network_opcode_station_profile
wlan_hosted_network_opcode_connection_settings

成功するには、 WlanHostedNetworkSetProperty 関数で新しい設定を保持する必要があります。これにより、Hosted Network 状態を現在実行中の場合は wlan_hosted_network_idle に移行する必要があります (wlan_hosted_network_active)。

任意のユーザーがこの関数を呼び出して、Hosted Network プロパティを設定できます。ただし、 wlan_hosted_network_opcode_enable フラグを設定するには、昇格された特権が必要です。ワイヤレスホスト型ネットワークを有効にする機能は、ドメイン内のグループポリシーによって制限される場合もあります。

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