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.
Wert | Bedeutung |
---|---|
|
Dieses Netzwerk ist derzeit verbunden. |
|
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 |