WLAN_AVAILABLE_NETWORK-Struktur (wlanapi.h)

Die WLAN_AVAILABLE_NETWORK-Struktur enthält Informationen zu einem verfügbaren Drahtlosnetzwerk.

Syntax

typedef struct _WLAN_AVAILABLE_NETWORK {
  WCHAR                  strProfileName[WLAN_MAX_NAME_LENGTH];
  DOT11_SSID             dot11Ssid;
  DOT11_BSS_TYPE         dot11BssType;
  ULONG                  uNumberOfBssids;
  BOOL                   bNetworkConnectable;
  WLAN_REASON_CODE       wlanNotConnectableReason;
  ULONG                  uNumberOfPhyTypes;
  DOT11_PHY_TYPE         dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER];
  BOOL                   bMorePhyTypes;
  WLAN_SIGNAL_QUALITY    wlanSignalQuality;
  BOOL                   bSecurityEnabled;
  DOT11_AUTH_ALGORITHM   dot11DefaultAuthAlgorithm;
  DOT11_CIPHER_ALGORITHM dot11DefaultCipherAlgorithm;
  DWORD                  dwFlags;
  DWORD                  dwReserved;
} WLAN_AVAILABLE_NETWORK, *PWLAN_AVAILABLE_NETWORK;

Member

strProfileName[WLAN_MAX_NAME_LENGTH]

Enthält den Profilnamen, der dem Netzwerk zugeordnet ist. Wenn das Netzwerk kein Profil hat, ist dieses Element leer. Wenn dem Netzwerk mehrere Profile zugeordnet sind, gibt es mehrere Einträge mit derselben SSID in der sichtbaren Netzwerkliste. Bei Profilnamen wird die Groß-/Kleinschreibung beachtet. Diese Zeichenfolge muss NULL-beendet sein.

dot11Ssid

Eine DOT11_SSID-Struktur , die die SSID des sichtbaren Drahtlosnetzwerks enthält.

dot11BssType

Ein DOT11_BSS_TYPE Wert, der angibt, ob es sich bei dem Netzwerk um Eine Infrastruktur oder ad hoc handelt.

uNumberOfBssids

Gibt die Anzahl der BSSIDs im Netzwerk an.

Windows XP mit SP3 und WLAN-API für Windows XP mit SP2: uNumberofBssids ist höchstens 1, unabhängig von der Anzahl der Zugriffspunkte, die die SSID senden.

bNetworkConnectable

Gibt an, ob das Netzwerk verbunden ist oder nicht. Wenn true festgelegt ist, kann das Netzwerk verbunden werden, andernfalls kann es nicht mit dem Netzwerk verbunden werden.

wlanNotConnectableReason

Ein WLAN_REASON_CODE Wert, der angibt, warum ein Netzwerk nicht verbunden werden kann. Dieser Member ist nur gültig, wenn bNetworkConnectablefalse ist.

uNumberOfPhyTypes

Die Anzahl der in verfügbaren Netzwerken unterstützten PHY-Typen. Der Maximalwert von uNumberOfPhyTypes ist WLAN_MAX_PHY_TYPE_NUMBER, der den Wert 8 aufweist. Wenn mehr als WLAN_MAX_PHY_TYPE_NUMBER PHY-Typen unterstützt werden, muss bMorePhyTypes auf TRUE festgelegt werden.

dot11PhyTypes[WLAN_MAX_PHY_TYPE_NUMBER]

Enthält ein Array von DOT11_PHY_TYPE Werten, die die von den verfügbaren Netzwerken unterstützten PHY-Typen darstellen. Wenn uNumberOfPhyTypes größer als WLAN_MAX_PHY_TYPE_NUMBER ist, enthält dieses Array nur die ersten WLAN_MAX_PHY_TYPE_NUMBER PHY-Typen.

Wert Bedeutung
dot11_phy_type_unknown
Gibt einen unbekannten oder nicht initialisierten PHY-Typ an.
dot11_phy_type_any
Gibt einen beliebigen PHY-Typ an.
dot11_phy_type_fhss
Gibt eine Hüpfungsfrequenz (Hüpfen von Spread-Spectrum, FHSS) an. Bluetooth-Geräte können FHSS oder eine Anpassung von FHSS verwenden.
dot11_phy_type_dsss
Gibt einen DSSS-PHY (Direct Sequence Spread Spectrum) an.
dot11_phy_type_irbaseband
Gibt ein Infrarot-Basisband (IR) PHY an.
dot11_phy_type_ofdm
Gibt einen ORTHOGONAL Frequency Division Multiplexing (OFDM) PHY an. 802.11a-Geräte können OFDM verwenden.
dot11_phy_type_hrdsss
Gibt einen HOCHRATEN-DSSS-PHY (HRDSSS) an.
dot11_phy_type_erp
Gibt eine erweiterte Raten-PHY (ERP) an. 802.11g-Geräte können ERP verwenden.
dot11_phy_type_ht
Gibt einen PHY-Typ 802.11n an.
dot11_phy_type_vht
Gibt den PHY-Typ 802.11ac an. Dies ist der PHY-Typ mit sehr hohem Durchsatz, der in IEEE 802.11ac angegeben ist.

Dieser Wert wird auf Windows 8.1, Windows Server 2012 R2 und höher unterstützt.

dot11_phy_type_IHV_start
Gibt den Anfang des Bereichs an, der zum Definieren von PHY-Typen verwendet wird, die von einem unabhängigen Hardwareanbieter (Independent Hardware Vendor, IHV) entwickelt werden.
dot11_phy_type_IHV_end
Gibt das Ende des Bereichs an, der zum Definieren von PHY-Typen verwendet wird, die von einem unabhängigen Hardwareanbieter (Independent Hardware Vendor, IHV) entwickelt werden.

bMorePhyTypes

Gibt an, ob mehr als WLAN_MAX_PHY_TYPE_NUMBER PHY-Typen unterstützt werden.

Wenn dieses Element auf TRUE festgelegt ist, muss eine Anwendung WlanGetNetworkBssList aufrufen, um die vollständige Liste der PHY-Typen abzurufen. Die zurückgegebene WLAN_BSS_LIST-Struktur verfügt über ein Array von WLAN_BSS_ENTRY Strukturen. Das uPhyId-Element der WLAN_BSS_ENTRY-Struktur enthält den PHY-Typ für einen Eintrag.

wlanSignalQuality

Ein Prozentwert, der die Signalqualität des Netzwerks darstellt. WLAN_SIGNAL_QUALITY ist vom Typ ULONG. Dieses Element enthält einen Wert zwischen 0 und 100. Ein Wert von 0 impliziert eine tatsächliche RSSI-Signalstärke von -100 dbm. Ein Wert von 100 impliziert eine tatsächliche RSSI-Signalstärke von -50 dbm. Sie können den RSSI-Signalstärkewert für wlanSignalQuality-Werte zwischen 1 und 99 mithilfe der linearen Interpolation berechnen.

bSecurityEnabled

Gibt an, ob die Sicherheit im Netzwerk aktiviert ist. Der Wert TRUE gibt an, dass die Sicherheit aktiviert ist, andernfalls nicht.

dot11DefaultAuthAlgorithm

Ein DOT11_AUTH_ALGORITHM Wert, der den Standardauthentifizierungsalgorithmus angibt, der zum ersten Mal für den Beitritt zu diesem Netzwerk verwendet wird.

dot11DefaultCipherAlgorithm

Ein DOT11_CIPHER_ALGORITHM Wert, der den Standardverschlüsselungsalgorithmus angibt, der beim Beitreten zu diesem Netzwerk verwendet werden soll.

dwFlags

Enthält verschiedene Flags für das Netzwerk.

Wert Bedeutung
WLAN_AVAILABLE_NETWORK_CONNECTED
Dieses Netzwerk ist derzeit verbunden.
WLAN_AVAILABLE_NETWORK_HAS_PROFILE
Es gibt ein Profil für dieses Netzwerk.

dwReserved

Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista, Windows XP mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile wlanapi.h
Verteilbare Komponente Wlan-API für Windows XP mit SP2

Weitere Informationen

WLAN_AVAILABLE_NETWORK_LIST