DOT11EXT_VIRTUAL_STATION_AP_PROPERTY-Struktur (wlanihv.h)

  • Artikel
Wichtig 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-Treibermodell.
 
Die DOT11EXT_VIRTUAL_STATION_AP_PROPERTY-Struktur gibt die Eigenschaften eines Access Point (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;

Member

dot11SSID

Eine DOT11_SSID-Struktur , die den Dienstsatzbezeichner (Service Set Identifier, SSID) enthält, der vom AP der virtuellen Station verwendet wird.

dot11AuthAlgo

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

dot11CipherAlgo

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

bIsPassPhrase

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

dwKeyLength

Die Länge des nützlichen Teils des ucKeyData-Members 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 PSK-Authentifizierungsalgorithmus (Preshared Keys) des virtuellen Stations-AP verwendet wird. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

Hinweise

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äre Daten 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 ist, wird ucKeyData als Passphrase interpretiert, und der Puffer muss NULL beendet sein. In diesem Fall sollte dwKeyLength einen Wert aufweisen, der gleich 1 und der Länge der Schlüsselzeichenfolge ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows 7 und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile wlanihv.h (include Wlanihv.h)

Weitere Informationen

DOT11_AUTH_ALGORITHM

DOT11_CIPHER_ALGORITHM

DOT11_SSID