WLAN_HOSTED_NETWORK_STATUS 構造体 (wlanapi.h)

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

WLAN_HOSTED_NETWORK_STATUS構造体には、ワイヤレスホスト型ネットワークの状態に関する情報が含まれています。

構文

typedef struct _WLAN_HOSTED_NETWORK_STATUS {
  WLAN_HOSTED_NETWORK_STATE      HostedNetworkState;
  GUID                           IPDeviceID;
  DOT11_MAC_ADDRESS              wlanHostedNetworkBSSID;
  DOT11_PHY_TYPE                 dot11PhyType;
  ULONG                          ulChannelFrequency;
  DWORD                          dwNumberOfPeers;
#if ...
  WLAN_HOSTED_NETWORK_PEER_STATE *PeerList[];
#else
  WLAN_HOSTED_NETWORK_PEER_STATE PeerList[1];
#endif
} WLAN_HOSTED_NETWORK_STATUS, *PWLAN_HOSTED_NETWORK_STATUS;

メンバー

HostedNetworkState

ワイヤレスホステッドネットワークの現在の状態。

このメンバーの値が wlan_hosted_network_unavailable場合は、この構造体の他のフィールドの値を使用しないでください。

IPDeviceID

ワイヤレスホスト型ネットワークに使用される実際のネットワークデバイス ID。

これは、 WlanEnumInterfaces 関数の呼び出しでは使用できない仮想ワイヤレスデバイスの GUID です。この GUID は、デバイス GUID を使用する他の上位レイヤーネットワーク関数 (IP ヘルパー関数など) を呼び出す場合に使用できます。

wlanHostedNetworkBSSID

パケット、ビーコン、プローブ応答でワイヤレスホステッドネットワークによって使用される BSSID。

dot11PhyType

ワイヤレスホステッドネットワークで使用されるネットワークインターフェイスの物理型。

これは、関連する物理インターフェイスによって報告される型の 1 つです。この値は、 HostedNetworkState メンバーが wlan_hosted_network_activeされている場合にのみ正しいです。

ulChannelFrequency

ワイヤレスホステッドネットワークで使用されるネットワークインターフェイスのチャネル周波数。

この値は、 HostedNetworkState が wlan_hosted_network_activeされている場合にのみ正しいです。

dwNumberOfPeers

ワイヤレスホステッドネットワーク上の認証済みピアの現在の数。

この値は、 HostedNetworkState が wlan_hosted_network_activeされている場合にのみ正しいです。

PeerList[*]

ワイヤレスホステッドネットワーク上の現在の各ピアを記述するWLAN_HOSTED_NETWORK_PEER_STATE構造体の配列。配列内の要素の数は、 dwNumberOfPeers メンバーによって指定されます。

この値は、 HostedNetworkState が wlan_hosted_network_activeされている場合にのみ正しいです。

PeerList[1]

この値は、 HostedNetworkState が wlan_hosted_network_activeされている場合にのみ正しいです。

注釈

WLAN_HOSTED_NETWORK_STATUS構造は、Windows 7 以降のワイヤレスホステッドネットワークをサポートするために追加されたネイティブワイヤレス API の拡張機能です。

WLAN_HOSTED_NETWORK_STATUS構造体は、wlanHostedNetworkQueryStatus 関数によって ppWlanHostedNetworkStatus パラメーター内のポインターで返されます。

要件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
Header	wlanapi.h (Wlanapi.h を含む)