WLAN_BSS_ENTRY-Struktur (wlanapi.h)
Die WLAN_BSS_ENTRY-Struktur enthält Informationen zu einem Basisdienstsatz (Basic Service Set, BSS).
Syntax
typedef struct _WLAN_BSS_ENTRY {
DOT11_SSID dot11Ssid;
ULONG uPhyId;
DOT11_MAC_ADDRESS dot11Bssid;
DOT11_BSS_TYPE dot11BssType;
DOT11_PHY_TYPE dot11BssPhyType;
LONG lRssi;
ULONG uLinkQuality;
BOOLEAN bInRegDomain;
USHORT usBeaconPeriod;
ULONGLONG ullTimestamp;
ULONGLONG ullHostTimestamp;
USHORT usCapabilityInformation;
ULONG ulChCenterFrequency;
WLAN_RATE_SET wlanRateSet;
ULONG ulIeOffset;
ULONG ulIeSize;
} WLAN_BSS_ENTRY, *PWLAN_BSS_ENTRY;
Member
dot11Ssid
Die SSID des Zugriffspunkts (AP) oder der Peerstation, die dem BSS zugeordnet ist. Der Datentyp für diesen Member ist eine DOT11_SSID-Struktur .
uPhyId
Der Bezeichner (ID) des PHY, den die WLAN-Schnittstelle verwendet hat, um das BSS-Netzwerk zu erkennen.
dot11Bssid
Die MAC-Adresse (Media Access Control) des Zugriffspunkts für BSS-Infrastrukturnetzwerke oder der Peerstation für unabhängige BSS-Netzwerke (Ad-hoc-Netzwerke), die den 802.11 Beacon- oder Probe Response-Frame gesendet haben, der von der WLAN-Schnittstelle während der Überprüfung empfangen wurde. Der Datentyp für diesen Member ist eine DOT11_MAC_ADDRESS-Struktur .
dot11BssType
Der BSS-Netzwerktyp. Der Datentyp für diesen Member ist ein DOT11_BSS_TYPE Enumerationswert.
Dieser Member kann einer der folgenden Werte sein.
| Wert | Bedeutung |
|---|---|
|
Gibt ein BSS-Infrastrukturnetzwerk an. |
|
Gibt ein unabhängiges BSS-Netzwerk (IBSS) an (ein Ad-hoc-Netzwerk). |
dot11BssPhyType
Der PHY-Typ für dieses Netzwerk. Der Datentyp für diesen Member ist ein DOT11_PHY_TYPE Enumerationswert.
lRssi
Der RSSI-Wert (Received Signal Strength Indicator) in Einheiten von Dezibeln, auf die auf 1,0 Milliwatt (dBm) verwiesen wird, wie vom Wireless LAN-Schnittstellentreiber für den AP oder die Peerstation erkannt.
uLinkQuality
Die vom Wireless LAN-Schnittstellentreiber gemeldete Verbindungsqualität. Der Wert der Linkqualität liegt zwischen 0 und 100. Der Wert 100 gibt die höchste Linkqualität an.
bInRegDomain
Ein -Wert, der angibt, ob der AP oder die Peerstation innerhalb der gesetzlichen Domäne betrieben wird, die durch das Land/die Region identifiziert wird.
Wenn der Wireless LAN-Schnittstellentreiber nicht mehrere regulatorische Domänen unterstützt, wird dieser Member auf TRUE festgelegt.
Wenn der 802.11 Beacon- oder Probe Response-Frame, der von der AP- oder Peerstation empfangen wird, kein Country Information Element (IE) enthält, wird dieses Element auf TRUE festgelegt.
Wenn der 802.11 Beacon- oder Testantwortframe, der von der AP- oder Peerstation empfangen wird, einen Country IE enthält, wird dieses Element auf FALSE festgelegt, wenn der Wert des Unterfelds Country String nicht der Eingabelandzeichenfolge entspricht.
usBeaconPeriod
Der Wert des Felds Beaconintervall aus dem 802.11 Beacon- oder Probe Response-Frame, der von der WLAN-Schnittstelle empfangen wird.
Das Intervall liegt in 1.024 Mikrosekunden-Zeiteinheiten zwischen den Sendezeiten des Ziel-Beacons. Diese Informationen werden aus dem Beaconpaket abgerufen, das von einem Zugriffspunkt in einem BSS-Infrastrukturnetzwerk oder einer Testantwort von einem Zugriffspunkt oder einer Peerstation als Reaktion auf einen Wlan-Client gesendet wird, der eine Testanforderung sendet.
Der IEEE 802.11-Standard definiert eine Zeiteinheit von 1.024 Mikrosekunden. Diese Einheit wurde so definiert, dass sie problemlos in Hardware implementiert werden konnte.
ullTimestamp
Der Wert des Zeitstempelfelds aus dem 802.11 Beacon- oder Probe Response-Frame, der von der WLAN-Schnittstelle empfangen wird.
ullHostTimestamp
Der Hostzeitstempelwert, der aufzeichnet, wann die WLAN-Schnittstelle den Beacon- oder Test response-Frame empfangen hat. Dieser Member ist eine Anzahl von 100-Nanosekunden-Intervallen seit dem 1. Januar 1601.
Weitere Informationen finden Sie in der im WDK dokumentierten NdisGetCurrentSystemTime-Funktion .
usCapabilityInformation
Der Wert des Felds Funktionsinformationen aus dem 802.11 Beacon- oder Probe Response-Frame, der von der WLAN-Schnittstelle empfangen wird. Dieser Wert ist ein Satz von Bitflags, die die Funktion definieren.
Bei diesem Member kann es sich um einen oder mehrere der folgenden Werte handeln.
ulChCenterFrequency
Die Kanalmittelfrequenz des Bandes, auf dem der 802.11 Beacon- oder Probe Response-Frame empfangen wurde. Der Wert von ulChCenterFrequency ist in Einheiten von Kilohertz (kHz) angegeben.
wlanRateSet
Eine Reihe von Datenübertragungsraten, die vom BSS unterstützt werden. Der Datentyp für diesen Member ist eine WLAN_RATE_SET-Struktur .
ulIeOffset
Der Offset des Datenblobs des Informationselements (IE) vom Anfang der WLAN_BSS_ENTRY-Struktur .
Dieser Member verweist auf einen Puffer, der Informationselemente mit variabler Länge aus dem 802.11-Beacon- oder Testantwortframes enthält. Für jede BSS stammen die IEs aus dem letzten Beacon- oder Probe Response-Frame, der von diesem BSS-Netzwerk empfangen wurde. Wenn ein IE nur in einem Frame verfügbar ist, führt der Wireless LAN-Schnittstellentreiber den IE mit den anderen IEs aus dem letzten empfangenen Beacon- oder Probe Response-Frame zusammen.
Informationselemente werden in den IEEE 802.11-Spezifikationen definiert, um ein allgemeines Format zu haben, das aus einem 1-Byte-Element-ID-Feld, einem 1-Byte-Längen-Feld für Länge und einem elementspezifischen Informationsfeld mit variabler Länge besteht. Jedem Informationselement wird ein eindeutiger Element-ID-Wert zugewiesen, wie in diesen IEEE 802.11-Standards definiert. Das Feld Länge gibt die Anzahl der Bytes im Informationsfeld an.
ulIeSize
Die Größe des IE-Datenblobs in Byte in der WLAN_BSS_ENTRY-Struktur .
Dies ist die genaue Länge der Daten im Puffer, auf die der ulIeOffset-Member verweist, und enthält keinen Abstand für die Ausrichtung. Der maximale Wert für die Größe des IE-Datenblobs beträgt 2.324 Bytes.
Hinweise
Die WlanGetNetworkBssList-Funktion ruft die BSS-Liste des drahtlosen Netzwerks oder der Netzwerke auf einer bestimmten Schnittstelle ab und gibt diese Informationen in einer WLAN_BSS_LIST-Struktur zurück, die ein Array von enthält. WLAN_BSS_ENTRY Strukturen.
Wenn die Wlan-Schnittstelle auch als drahtlos gehostetes Netzwerk ausgeführt wird, enthält die BSS-Liste einen Eintrag für die BSS, die für das drahtlos gehostete Netzwerk erstellt wurde.
Da die Informationen vom Zugriffspunkt für ein BSS-Infrastrukturnetzwerk oder vom Netzwerkpeer für ein unabhängiges BSS-Netzwerk (Ad-hoc-Netzwerk) zurückgegeben werden, sollten die zurückgegebenen Informationen nicht vertrauenswürdig sein. Die Elemente ulIeOffset und ulIeSize in der WLAN_BSS_ENTRY-Struktur sollten verwendet werden, um die maximale Größe des Datenblobs des Informationselements in der WLAN_BSS_ENTRY-Struktur zu bestimmen, nicht die Daten im Datenblob des Informationselements.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Kopfzeile | wlanapi.h |