WLAN_HOSTED_NETWORK_STATUS結構 (wlanapi.h)

發行項
03/09/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

用於無線託管網路的實際網路裝置標識碼。

這是虛擬無線裝置的 GUID，無法透過對 WlanEnumInterfaces 函式的呼叫取得。此 GUID 可用於呼叫其他使用裝置 GUID (IP 協助程式函式的較高層網路功能，例如) 。

wlanHostedNetworkBSSID

無線託管網路在封包、指標和探查回應中使用的 BSSID。

dot11PhyType

無線託管網路所使用的網路介面實體類型。

這是相關實體介面所報告的其中一種類型。只有在 HostedNetworkState 成員 wlan_hosted_network_active時，這個值才正確。

ulChannelFrequency

無線託管網路所使用的網路介面通道頻率。

只有在 HostedNetworkStatewlan_hosted_network_active時，這個值才正確。

dwNumberOfPeers

無線託管網路上目前已驗證的對等數目。

只有在 HostedNetworkStatewlan_hosted_network_active時，這個值才正確。

PeerList[*]

描述無線託管網路上每個目前對等之WLAN_HOSTED_NETWORK_PEER_STATE結構的陣列。陣列中的元素數目是由 dwNumberOfPeers 成員所指定。

只有在 HostedNetworkStatewlan_hosted_network_active時，這個值才正確。

PeerList[1]

描述無線託管網路上每個目前對等之WLAN_HOSTED_NETWORK_PEER_STATE結構的陣列。陣列中的元素數目是由 dwNumberOfPeers 成員所指定。

只有在 HostedNetworkStatewlan_hosted_network_active時，這個值才正確。

備註

WLAN_HOSTED_NETWORK_STATUS結構是新增的原生無線 API 延伸模組，可支援 Windows 7 和更新版本的無線託管網路。

WLAN_HOSTED_NETWORK_STATUS 結構是由 WlanHostedNetworkQueryStatus 函式在 ppWlanHostedNetworkStatus 參數的指標中傳回。

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限傳統型應用程式]
標頭	wlanapi.h (包含 Wlanapi.h)