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.

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.

dwReserved

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

Anforderungen

Weitere Informationen

WLAN_AVAILABLE_NETWORK_LIST