DOT11_AUTH_CIPHER_PAIR_LIST-Struktur (windot11.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 DOT11_AUTH_CIPHER_PAIR_LIST-Struktur definiert eine Liste mit DOT11_AUTH_CIPHER_PAIR Strukturen.

Syntax

typedef struct DOT11_AUTH_CIPHER_PAIR_LIST {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uNumOfEntries;
  ULONG                  uTotalNumOfEntries;
  DOT11_AUTH_CIPHER_PAIR AuthCipherPairs[1];
} DOT11_AUTH_CIPHER_PAIR_LIST, *PDOT11_AUTH_CIPHER_PAIR_LIST;

Member

Header

Der Typ, die Revision und die Größe der DOT11_AUTH_CIPHER_PAIR_LIST-Struktur. Dieses Element ist als NDIS_OBJECT_HEADER-Struktur formatiert.

Der Miniporttreiber muss die Member von Header auf die folgenden Werte festlegen:

Typ

Dieser Member muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.

Revision

Dieser Member muss auf DOT11_AUTH_CIPHER_PAIR_LIST_REVISION_1 festgelegt werden.

Size

Dieses Element muss auf sizeof(DOT11_AUTH_CIPHER_PAIR_LIST)festgelegt werden.

Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.

uNumOfEntries

Die Anzahl der Einträge im AuthCipherPairs-Array .

uTotalNumOfEntries

Die maximale Anzahl von Einträgen, die das AuthCipherPairs-Array enthalten kann.

AuthCipherPairs[1]

Die Liste der DOT11_AUTH_CIPHER_PAIR Strukturen.

Hinweise

Ein Miniporttreiber gibt die DOT11_AUTH_CIPHER_PAIR_LIST-Struktur zurück, wenn er von einem der Beiden abgefragt wird. OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR oder OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.

Wenn diese OIDs abgefragt werden, muss der Miniporttreiber überprüfen, ob der InformationBuffer-Member des OidRequest-Parameters der MiniportOidRequest-Funktion groß genug ist, um die gesamte DOT11_AUTH_CIPHER_PAIR_LIST-Struktur zurückzugeben, einschließlich aller Einträge im AuthCipherPairs-Array. Der Wert des InformationBufferLength-Members des OidRequest-Parameters bestimmt, was der Miniporttreiber tun muss, wie die folgende Liste zeigt:

  • Wenn der Wert des InformationBufferLength-Members kleiner als die Länge (in Bytes) der gesamten DOT11_AUTH_CIPHER_PAIR_LIST-Struktur ist, muss der Miniporttreiber folgendes tun:
    • Legen Sie für den OidRequest-Parameter das BytesWritten-Element auf Null und das BytesNeed-Element auf die Länge der gesamten DOT11_AUTH_CIPHER_PAIR_LIST-Struktur in Bytes fest.
    • Führen Sie einen Fehler für die Abfrageanforderung durch Zurückgeben NDIS_STATUS_BUFFER_OVERFLOW aus der MiniportOidRequest-Funktion aus.
  • Wenn der Wert des InformationBufferLength-Members größer oder gleich der Länge (in Bytes) der gesamten DOT11_AUTH_CIPHER_PAIR_LIST-Struktur ist, muss der Miniporttreiber die folgenden Schritte ausführen, um eine erfolgreiche Abfrageanforderung abzuschließen:
    • Legen Sie für die DOT11_AUTH_CIPHER_PAIR_LIST-Struktur die Elemente uNumOfEntries und uTotalNumOfEntries auf die Gesamtzahl der Einträge im AuthCipherPairs-Array fest.
    • Legen Sie für den OidRequest-Parameter den BytesNeed-Member auf Null und den BytesWritten-Member auf die Länge der gesamten DOT11_AUTH_CIPHER_PAIR_LIST-Struktur in Bytes fest. Der Miniporttreiber muss auch die gesamte DOT11_AUTH_CIPHER_PAIR_LIST-Struktur in das InformationBuffer-Element kopieren.
    • Gibt NDIS_STATUS_SUCCESS aus der MiniportOidRequest-Funktion zurück.
Ab Windows 7 kann ein 802.11-Miniporttreiber eine beliebige Kombination aus unterstützten Authentifizierungs- und Verschlüsselungsalgorithmuspaaren in DOT11_AUTH_CIPHER_PAIR_LIST melden. Wenn das Betriebssystem Soft AP jedoch startet, aktiviert es nur den DOT11_AUTH_ALGO_RSNA_PSK-Authentifizierungsalgorithmus und den DOT11_CIPHER_ALGO_CCMP Verschlüsselungsalgorithmus. Um Soft AP zu unterstützen, muss der Miniporttreiber dieses Authentifizierungs-/Verschlüsselungspaar unterstützen.

Wenn WPS für eine NIC aktiviert ist, die im Extensible AP-Modus ausgeführt wird, muss der Miniporttreiber zulassen, dass Peerstationen der Extensible AP mithilfe von WeP-Algorithmen ( Open System Authentication ) oder WeP (Wired Equivalent Privacy) zugeordnet werden können, unabhängig von den aktivierten Autorisierungs- und Verschlüsselungsalgorithmen. Weitere Informationen zu WPS und Extensible AP finden Sie unter OID_DOT11_WPS_ENABLED.

Anforderungen

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

Weitere Informationen

OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_AUTH_CIPHER_PAIR

NDIS_OBJECT_HEADER