DOT11EXT_VIRTUAL_STATION_AP_PROPERTY Struktur (wlanihv.h)

Artikel
02/07/2025

Wichtige Die Native 802.11 Wireless LAN--Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter WLAN Universal Windows driver model.

Die DOT11EXT_VIRTUAL_STATION_AP_PROPERTY-Struktur gibt die Eigenschaften eines Zugriffspunkts (AP) an, der auf einer virtuellen 802.11-Station gehostet wird.

Syntax

typedef struct _DOT11EXT_VIRTUAL_STATION_AP_PROPERTY {
  DOT11_SSID             dot11SSID;
  DOT11_AUTH_ALGORITHM   dot11AuthAlgo;
  DOT11_CIPHER_ALGORITHM dot11CipherAlgo;
  BOOL                   bIsPassPhrase;
  DWORD                  dwKeyLength;
  UCHAR                  ucKeyData[DOT11EXT_PSK_MAX_LENGTH];
} DOT11EXT_VIRTUAL_STATION_AP_PROPERTY, *PDOT11EXT_VIRTUAL_STATION_AP_PROPERTY;

Angehörige

dot11SSID

Eine DOT11_SSID Struktur, die den dienstsatzbezeichner (SSID) enthält, der von der virtuellen Station-AP verwendet wird.

dot11AuthAlgo

Eine DOT11_AUTH_ALGORITHM Struktur, die den Authentifizierungsalgorithmus enthält, der von der virtuellen Station-AP verwendet wird.

dot11CipherAlgo

Eine DOT11_CIPHER_ALGORITHM Struktur, die den verschlüsselungsalgorithmus enthält, der von der virtuellen Station-AP verwendet wird.

bIsPassPhrase

Ein boolescher Wert, der angibt, wie das Betriebssystem den Wert des ucKeyData Member interpretieren soll. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

dwKeyLength

Die Länge des nützlichen Teils des ucKeyData--Elements in Bytes. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

ucKeyData[DOT11EXT_PSK_MAX_LENGTH]

Ein UCHAR-Wert, der den schlüssel angibt, der vom Authentifizierungsalgorithmus der virtuellen Station-AP (Preshared Keys, PSK) verwendet wird. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Bemerkungen

Das Betriebssystem verwendet die folgende Logik, um den Wert des ucKeyData Members zu interpretieren:

Wenn bIsPassPhrase = FALSE,
- Wenn dwKeyLength = 32 ist, wird ucKeyData- als Binärdaten interpretiert.
- Wenn dwKeyLength = 64 ist, wird ucKeyData- als 32 Hexadezimalwerte interpretiert.
- Wenn dwKeyLength- nicht gleich 32 oder 64 ist, ignoriert das Betriebssystem den Aufruf und gibt einen Fehler zurück.
Wenn bIsPassPhrase = TRUE, wird ucKeyData- als Passausdruck interpretiert, und der Puffer muss NULL beendet werden. In diesem Fall sollte dwKeyLength- einen Wert aufweisen, der 1 plus der Länge der Schlüsselzeichenfolge entspricht.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 7 und höheren Versionen von Windows-Betriebssystemen.
Header-	wlanihv.h (inklusive Wlanihv.h)

Siehe auch

DOT11_AUTH_ALGORITHM

DOT11_CIPHER_ALGORITHM

DOT11_SSID

Freigeben über