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) |