WLAN_HOSTED_NETWORK_STATUS-Struktur (wlanapi.h)

Die WLAN_HOSTED_NETWORK_STATUS-Struktur enthält Informationen über die status des drahtlos gehosteten Netzwerks.

Syntax

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;

Member

HostedNetworkState

Der aktuelle Zustand des drahtlos gehosteten Netzwerks.

Wenn der Wert dieses Members wlan_hosted_network_unavailable ist, sollten die Werte der anderen Felder in dieser Struktur nicht verwendet werden.

IPDeviceID

Die tatsächliche Netzwerkgeräte-ID, die für das drahtlos gehostete Netzwerk verwendet wird.

Hierbei handelt es sich um die GUID eines virtuellen drahtlosen Geräts, das nicht über Aufrufe der WlanEnumInterfaces-Funktion verfügbar wäre. Diese GUID kann zum Aufrufen anderer Höherschicht-Netzwerkfunktionen verwendet werden, die die Geräte-GUID (z. B. IP-Hilfsfunktionen) verwenden.

wlanHostedNetworkBSSID

Die BSSID, die vom drahtlos gehosteten Netzwerk in Paketen, Beacons und Testantworten verwendet wird.

dot11PhyType

Der physische Typ der Netzwerkschnittstelle, die vom drahtlosen gehosteten Netzwerk verwendet wird.

Dies ist einer der Typen, die von der zugehörigen physischen Schnittstelle gemeldet werden. Dieser Wert ist nur richtig, wenn das HostedNetworkState-Elementwlan_hosted_network_active ist.

ulChannelFrequency

Die Kanalhäufigkeit der Netzwerkschnittstelle, die vom drahtlosen gehosteten Netzwerk verwendet wird.

Dieser Wert ist nur richtig, wenn HostedNetworkStatewlan_hosted_network_active ist.

dwNumberOfPeers

Die aktuelle Anzahl authentifizierter Peers im drahtlos gehosteten Netzwerk.

Dieser Wert ist nur richtig, wenn HostedNetworkStatewlan_hosted_network_active ist.

PeerList[*]

Ein Array von WLAN_HOSTED_NETWORK_PEER_STATE Strukturen, die die aktuellen Peers im gehosteten Drahtlosnetzwerk beschreiben. Die Anzahl der Elemente im Array wird vom dwNumberOfPeers-Element angegeben.

Dieser Wert ist nur richtig, wenn HostedNetworkStatewlan_hosted_network_active ist.

PeerList[1]

Ein Array von WLAN_HOSTED_NETWORK_PEER_STATE Strukturen, die die aktuellen Peers im gehosteten Drahtlosnetzwerk beschreiben. Die Anzahl der Elemente im Array wird vom dwNumberOfPeers-Element angegeben.

Dieser Wert ist nur richtig, wenn HostedNetworkStatewlan_hosted_network_active ist.

Hinweise

Die WLAN_HOSTED_NETWORK_STATUS-Struktur ist eine Erweiterung nativer Drahtlos-APIs, die zur Unterstützung des gehosteten Drahtlosnetzwerks unter Windows 7 und höher hinzugefügt wurden.

Die WLAN_HOSTED_NETWORK_STATUS Struktur wird in einem Zeiger im ppWlanHostedNetworkStatus-Parameter von der WlanHostedNetworkQueryStatus-Funktion zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Kopfzeile	wlanapi.h (einschließlich Wlanapi.h)

Weitere Informationen

DOT11_MAC_ADDRESS

DOT11_PHY_TYPE

WLAN_HOSTED_NETWORK_PEER_STATE

WLAN_HOSTED_NETWORK_STATE

WlanEnumInterfaces

WlanHostedNetworkQueryStatus