WLAN_HOSTED_NETWORK_STATUS 结构 (wlanapi.h)

项目
03/13/2024

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。

此成员是虚拟无线设备的 GUID，无法通过调用 WlanEnumInterfaces 函数获取。此 GUID 可用于调用使用设备 GUID (IP 帮助程序函数的其他高层网络函数，例如) 。

wlanHostedNetworkBSSID

无线托管网络在数据包、信标和探测响应中使用的 BSSID。

dot11PhyType

无线托管网络使用的网络接口的物理类型。

这是相关物理接口报告的类型之一。仅当 HostedNetworkState 成员 wlan_hosted_network_active时，此值才正确。

ulChannelFrequency

无线托管网络使用的网络接口的通道频率。

仅当wlan_hosted_network_active HostedNetworkState 时，此值才正确。

dwNumberOfPeers

无线托管网络上的当前经过身份验证的对等方数。

仅当wlan_hosted_network_active HostedNetworkState 时，此值才正确。

PeerList[*]

描述无线托管网络上每个当前对等方 WLAN_HOSTED_NETWORK_PEER_STATE 结构的数组。数组中的元素数由 dwNumberOfPeers 成员提供。

仅当wlan_hosted_network_active HostedNetworkState 时，此值才正确。

PeerList[1]

描述无线托管网络上每个当前对等方 WLAN_HOSTED_NETWORK_PEER_STATE 结构的数组。数组中的元素数由 dwNumberOfPeers 成员提供。

仅当wlan_hosted_network_active HostedNetworkState 时，此值才正确。

注解

WLAN_HOSTED_NETWORK_STATUS结构是添加到本机无线 API 的扩展，以支持 Windows 7 及更高版本上的无线托管网络。

WLAN_HOSTED_NETWORK_STATUS结构由 WlanHostedNetworkQueryStatus 函数在 ppWlanHostedNetworkStatus 参数的指针中返回。

要求

要求	值
最低受支持的客户端	Windows 7 [仅限桌面应用]
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
标头	wlanapi.h (包括 Wlanapi.h)