WLAN_BSS_ENTRY-Struktur (wlanapi.h)

Artikel
08/28/2023

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
dot11_BSS_type_infrastructure 1	Gibt ein BSS-Infrastrukturnetzwerk an.
dot11_BSS_type_independent 2	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.

Wert	Bedeutung
ESS Bit 0	Ein erweiterter Dienstsatz. Ein Satz von einem oder mehreren miteinander verbundenen Basisdienstsätzen (BSSs) und integrierten lokalen Netzwerken (LOCAL AREA Networks, LANs), die als einzelne BSS für die Steuerungsebene logischer Verbindungen an jeder Station angezeigt werden, die einer dieser BSSs zugeordnet ist. Ein AP legt das ESS-Unterfeld auf 1 und das IBSS-Unterfeld auf 0 innerhalb des übertragenen Beacon- oder Probe Response-Frames fest. Eine Peerstation innerhalb eines IBSS-Netzwerks (Ad-hoc-Netzwerk) legt das ESS-Unterfeld auf 0 und das IBSS-Unterfeld auf 1 in übertragenen Beacon- oder Probe Response-Frames fest.
IBSS Bit 1	Ein unabhängiger Basisdienstsatz. Ein BSS, der ein eigenständiges Netzwerk bildet und in dem kein Zugriff auf ein Verteilungssystem (DS) verfügbar ist (ein Ad-hoc-Netzwerk). Ein AP legt das ESS-Unterfeld auf 1 und das IBSS-Unterfeld auf 0 in übertragenen Beacon- oder Testantwortframes fest. Eine Peerstation innerhalb eines IBSS-Netzwerks (Ad-hoc-Netzwerk) legt das ESS-Unterfeld auf 0 und das IBSS-Unterfeld auf 1 in übertragenen Beacon- oder Probe Response-Frames fest.
CF-Pollable Bit 2	Ein -Wert, der angibt, ob der AP oder die Peerstation abrufbar ist.
CF-Abfrageanforderung Bit 3	Ein -Wert, der angibt, wie der AP oder die Peerstation Umfrageanforderungen verarbeitet.
Datenschutz Bit 4	Ein -Wert, der angibt, ob eine Verschlüsselung für alle Datenframes erforderlich ist. Ein AP legt das Unterfeld Datenschutz innerhalb der übertragenen Beacon- und Testantwortframes auf 1 fest, wenn eine WEP-, WPA- oder WPA2-Verschlüsselung für alle Datentypframes erforderlich ist, die innerhalb des BSS ausgetauscht werden. Wenn die WEP-, WPA- oder WPA2-Verschlüsselung nicht erforderlich ist, wird das Unterfeld Datenschutz auf 0 festgelegt. Eine Peerstation innerhalb von und IBSS legt das Unterfeld Datenschutz innerhalb der übertragenen Beacon- und Testantwortframes auf 1 fest, wenn für alle innerhalb des IBSS ausgetauschten Datentypframes eine WEP-, WPA- oder WPA2-Verschlüsselung erforderlich ist. Wenn die WEP-, WPA- oder WPA2-Verschlüsselung nicht erforderlich ist, wird das Unterfeld Datenschutz auf 0 festgelegt.

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.

Hinweis Dieser Member ist nur für PHY-Typen gültig, die kein Frequenzhopping-Spread-Spektrum (FHSS) sind.

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

Weitere Informationen

WLAN_AVAILABLE_NETWORK

WLAN_AVAILABLE_NETWORK_LIST

WLAN_BSS_LIST

WlanGetAvailableNetworkList

WlanGetNetworkBssList

Freigeben über