WlanHostedNetworkQueryProperty 関数 (wlanapi.h)
WlanHostedNetworkQueryProperty 関数は、ワイヤレス ホステッド ネットワークの現在の静的プロパティに対してクエリを実行します。
DWORD WlanHostedNetworkQueryProperty(
[in] HANDLE hClientHandle,
[in] WLAN_HOSTED_NETWORK_OPCODE OpCode,
[out] PDWORD pdwDataSize,
[out] PVOID *ppvData,
[out] PWLAN_OPCODE_VALUE_TYPE pWlanOpcodeValueType,
PVOID pvReserved
);
[in] hClientHandle
WlanOpenHandle 関数の以前の呼び出しによって返されるクライアントのセッション ハンドル。
[in] OpCode
クエリを実行するプロパティの識別子。 この識別子には、Wlanapi.h ヘッダー ファイルで定義されているWLAN_HOSTED_NETWORK_OPCODE列挙の値のいずれかを指定できます。
[out] pdwDataSize
WlanHostedNetworkQueryProperty 関数の呼び出しが成功した場合に、ppvData パラメーターで返されるバッファーのサイズをバイト単位で指定する値へのポインター。
[out] ppvData
入力時に、このパラメーターは NULL である必要があります。
出力時に、このパラメーターは 、WlanHostedNetworkQueryProperty 関数の呼び出しが成功した場合に、要求された静的プロパティで返されるバッファーへのポインターを受け取ります。 このバッファーに関連付けられているデータ型は、 OpCode パラメーターの値によって異なります。
[out] pWlanOpcodeValueType
WlanHostedNetworkQueryProperty 関数の呼び出しが成功した場合に、ワイヤレス Hosted Network プロパティの値型を受け取る値へのポインター。 返される値は、Wlanapi.h ヘッダー ファイルで定義されているWLAN_OPCODE_VALUE_TYPE列挙の列挙型です。
pvReserved
将来利用するために予約されています。 このパラメーターは NULL である必要があります。
関数が成功した場合、戻り値は ERROR_SUCCESS です。
関数が失敗した場合、戻り値は次のいずれかのリターン コードになります。
リターン コード | 説明 |
---|---|
|
ワイヤレス ホステッド ネットワークの構成データは構成されていません。 このエラーは、アプリケーションが WlanHostedNetworkQueryProperty 関数を呼び出し、 OpCode パラメーターを wlan_hosted_network_opcode_station_profile または wlan_hosted_network_opcode_connection_settings に設定した場合に、ワイヤレス ホステッド ネットワークで SSID が構成される前に返されます。 |
|
ハンドルが無効です。 このエラーは、 hClientHandle パラメーターで指定されたハンドルがハンドル テーブルで見つからなかった場合に返されます。 |
|
パラメーターが正しくありません。 このエラーは、次のいずれかの条件が発生した場合に返されます。
|
|
リソースが、要求された操作を実行するための正しい状態ではありません。 これは、ワイヤレス ホステッド ネットワークがシャットダウン中の場合に発生する可能性があります。 |
|
この操作を実行するには、使用できる領域が十分ではありません。 |
|
サービスは開始されていません。 このエラーは、WLAN AutoConfig サービスが実行されていない場合に返されます。 |
|
さまざまな RPC とその他のエラー コード。 FormatMessage を使用して、返されたエラーのメッセージ文字列を取得します。 |
WlanHostedNetworkQueryProperty 関数は、ワイヤレス LAN サービスがインストールされた Windows 7 および Windows Server 2008 R2 のワイヤレス ホステッド ネットワークをサポートするために追加されたネイティブ ワイヤレス API の拡張機能です。
クライアント アプリケーションは WlanHostedNetworkQueryProperty 関数を呼び出して、ワイヤレス ホステッド ネットワークの現在の静的プロパティに対してクエリを実行します。 この機能は、ワイヤレス ホステッド ネットワークの状態またはプロパティを変更しません。
関数が成功した場合、 ppvData パラメーターは要求されたプロパティを含むバッファーを指します。 このバッファーのサイズは、 pwdDataSize パラメーターで返されるポインターで返されます。 WLAN_OPCODE_VALUE_TYPEは、pWlanOpcodeValueType パラメーターで返されるポインターで返されます。 返される ppvData パラメーターのバッファーに使用されるメモリは、バッファーが不要になった後に WlanFreeMemory 関数を呼び出すことによって解放する必要があります。
ppvData パラメーターが指すバッファーに関連付けられているデータ型は、次のように OpCode パラメーターの値によって異なります。
OpCode | 説明 |
---|---|
wlan_hosted_network_opcode_connection_settings | WLAN_HOSTED_NETWORK_CONNECTION_SETTINGS構造体へのポインターが返されます。 |
wlan_hosted_network_opcode_security_settings | WLAN_HOSTED_NETWORK_SECURITY_SETTINGS構造体へのポインターが返されます。 |
wlan_hosted_network_opcode_station_profile | ワイヤレスホステッド ネットワークに接続するための XML WLAN プロファイルを含む PWSTR が返されます。 |
wlan_hosted_network_opcode_enable | ワイヤレス ホステッド ネットワークが有効になっているかどうかを示す PBOOL が返されます。 |
ワイヤレス ホステッド ネットワークで SSID が構成される前 に、WlanHostedNetworkQueryProperty 関数が OpCode パラメーターに次のいずれかの値を渡した場合、この関数は ERROR_BAD_CONFIGURATIONで失敗します。
- wlan_hosted_network_opcode_station_profile
- wlan_hosted_network_opcode_connection_settings
どのユーザーも WlanHostedNetworkQueryProperty 関数を呼び出して、Hosted Network プロパティに対してクエリを実行できます。
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 |
ワイヤレス ホステッド ネットワークとインターネット接続共有の使用
WLAN_HOSTED_NETWORK_CONNECTION_SETTINGS
WLAN_HOSTED_NETWORK_SECURITY_SETTINGS
WlanHostedNetworkQuerySecondaryKey
WlanHostedNetworkRefreshSecuritySettings