WlanHostedNetworkQueryStatus 関数 (wlanapi.h)

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

WlanHostedNetworkQueryStatus 関数は、ワイヤレスホスト型ネットワークの現在の状態を照会します。

構文

DWORD WlanHostedNetworkQueryStatus(
  [in]  HANDLE                      hClientHandle,
  [out] PWLAN_HOSTED_NETWORK_STATUS *ppWlanHostedNetworkStatus,
        PVOID                       pvReserved
);

パラメーター

[in] hClientHandle

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

[out] ppWlanHostedNetworkStatus

入力時に、このパラメーターは NULL である必要があります。

WlanHostedNetworkQueryStatus 関数の呼び出しが成功した場合、出力時に、このパラメーターはワイヤレス Hosted Network の現在の状態へのポインターを受け取ります。現在の状態は、 WLAN_HOSTED_NETWORK_STATUS 構造体で返されます。

pvReserved

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

戻り値

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

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

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

注釈

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

クライアントアプリケーションは WlanHostedNetworkQueryStatus 関数を呼び出して、ワイヤレスホスト型ネットワークの現在の状態を照会します。この機能は、ワイヤレスホステッドネットワークの状態を変更しません。

関数が成功した場合、 ppWlanHostedNetworkStatus パラメーターは、現在の状態を持つ WLAN_HOSTED_NETWORK_STATUS 構造体を指します。返される WLAN_HOSTED_NETWORK_STATUS 構造体に使用されるメモリは、 WlanFreeMemory 関数を呼び出して使用後に解放する必要があります。

どのユーザーも WlanHostedNetworkQueryStatus 関数を呼び出して、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