WlanHostedNetworkQueryStatus 関数 (wlanapi.h)

  • [アーティクル]

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

こちらもご覧ください

ワイヤレス ホステッド ネットワークについて

ワイヤレス ホスト型ネットワークとインターネット接続共有の使用

WLAN_HOSTED_NETWORK_STATUS

WlanEnumInterfaces

WlanFreeMemory

WlanHostedNetworkQueryProperty

WlanHostedNetworkQuerySecondaryKey

WlanOpenHandle