DOT11_CIPHER_DEFAULT_KEY_VALUE-Struktur (windot11.h)

Artikel
03/05/2024

Wichtig

Die native WLAN-Schnittstelle 802.11 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 DOT11_CIPHER_DEFAULT_KEY_VALUE-Struktur definiert einen Standardchiffreschlüssel oder einen Standardverschlüsselungsschlüssel pro Station, der den Schlüsseltabellen auf der Station 802.11 hinzugefügt oder daraus gelöscht wird. Weitere Informationen zu diesen Verschlüsselungsschlüsseltypen finden Sie unter 802.11 Verschlüsselungsschlüsseltypen.

Syntax

typedef struct DOT11_CIPHER_DEFAULT_KEY_VALUE {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uKeyIndex;
  DOT11_CIPHER_ALGORITHM AlgorithmId;
  DOT11_MAC_ADDRESS      MacAddr;
  BOOLEAN                bDelete;
  BOOLEAN                bStatic;
  USHORT                 usKeyLength;
  UCHAR                  ucKey[1];
} DOT11_CIPHER_DEFAULT_KEY_VALUE, *PDOT11_CIPHER_DEFAULT_KEY_VALUE;

Member

Header

Typ, Revision und Größe der DOT11_CIPHER_DEFAULT_KEY_VALUE-Struktur. Dieser Member 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_CIPHER_DEFAULT_KEY_VALUE_REVISION_1 festgelegt werden.

Size

Dieser Member muss auf sizeof(DOT11_CIPHER_DEFAULT_KEY_VALUE)festgelegt werden.

Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.

uKeyIndex

Der Index des Schlüssels im Standardschlüsselarray der Station 802.11.

Für 802.11-Verschlüsselungsalgorithmen muss uKeyIndex zwischen 0 und 3 sein. Bei einem von einem IHV entwickelten Verschlüsselungsalgorithmus kann uKeyIndex ein beliebiger Wert innerhalb des durch die IHV definierten Bereichs sein.

Für BIP muss uKeyIndex 4 oder 5 sein.

Der IEEE 802.11-2012-Standard definiert Standardschlüsselindexwerte von 1 bis 4. Der von diesem Member angegebene Wert x wird dem Standardschlüsselindex 802.11 (x + 1) zugeordnet.

AlgorithmId

Der Wert des Verschlüsselungsalgorithmus, der diesen Schlüssel verwendet. Weitere Informationen zu Werten für Verschlüsselungsalgorithmen finden Sie unter DOT11_CIPHER_ALGORITHM.

Für BIP sollte dies auf DOT11_CIPHER_ALGO_BIP festgelegt werden, um die anfängliche IGTK-Paketnummer vorab festzulegen.

Der Miniporttreiber muss diesen Member ignorieren, wenn bDeleteauf TRUE festgelegt ist.

MacAddr

Die MAC-Adresse (Media Access Control), die die Standardschlüsseltabelle zum Hinzufügen oder Entfernen des Schlüssels angibt.

Wenn das MIB-Objekt ( dot11DesiredBSSSType Management Information Base) auf dot11_BSS_type_infrastructure festgelegt ist, fügt die Station 802.11 den Schlüssel der Standardschlüsseltabelle hinzu oder entfernt diesen, unabhängig vom Wert des MacAddr-Elements . Wenn der Schlüssel dynamisch vom Zugriffspunkt (AP) abgerufen wird, dem die Station zugeordnet ist, enthält das MacAddr-Element die MAC-Adresse des AP. Andernfalls weist MacAddr den Wert 0x000000000000 auf.

Wenn das MIB-Objekt ( dot11DesiredBSSSType Management Information Base) auf dot11_BSS_type_independent festgelegt ist, muss die Station 802.11 den Schlüssel wie folgt hinzufügen oder entfernen:

Wenn der Wert dieses Members 0x000000000000 ist, fügt die 802.11-Station den Schlüssel der Standardschlüsseltabelle hinzu oder entfernt diesen. Wenn sich die NIC im OP-Modus Extensible Access Point (Extensible Access Point) befindet, ist dieser Wert 0 .
Wenn der Wert dieses Members eine gültige Unicast-MAC-Adresse ist, fügt die 802.11-Station den Schlüssel aus der Standardschlüsseltabelle pro Station für die Peerstation in einem unabhängigen BSS-Netzwerk (IBSS) mit einer MAC-Adresse hinzu, die dem Wert von MacAddr entspricht.

Wenn für den MacAddr-Wert keine Standardschlüsseltabelle pro Station vorhanden ist, muss die 802.11-Station jede nicht verwendete Standardschlüsseltabelle pro Station verwenden.

Weitere Informationen zum MIB-Objekt dot11DesiredBSSSType finden Sie unter OID_DOT11_DESIRED_BSS_TYPE.

bDelete

Ein boolescher Wert, der angibt, ob der Miniporttreiber den Standardschlüssel löschen soll.

Wenn true festgelegt ist, muss der Miniporttreiber den Standardschlüssel löschen, auf den von uKeyIndex verwiesen wird. Wenn dieser Wert auf FALSE festgelegt ist, muss der Miniporttreiber den Standardschlüssel hinzufügen oder aktualisieren, auf den von uKeyIndex verwiesen wird.

bStatic

Ein boolescher Wert, der angibt, ob der Miniporttreiber den Standardschlüssel nach einem Verbindungs- oder Roamingvorgang löschen soll.

Wenn dieser Wert auf FALSE festgelegt ist, muss der Miniporttreiber den Standardschlüssel löschen, auf den uKeyIndex verweist, wenn die Station 802.11:

Trennt die Verbindung mit dem BSS-Netzwerk (Basic Service Set).
Wird in ein neues BSS-Netzwerk übertragen.
Stellt erneut eine Verbindung mit demselben BSS-Netzwerk her.

Bei Festlegung auf TRUE darf der Standardschlüssel, auf den von uKeyIndex verwiesen wird, nicht gelöscht werden, es sei denn, er lautet:

Explizit durch eine set-Anforderung von OID_DOT11_CIPHER_DEFAULT_KEY gelöscht.
Implizit durch eine Methodenanforderung von OID_DOT11_RESET_REQUEST gelöscht.

usKeyLength

Die Länge des Schlüsselmaterials im ucKey-Array in Byte.

ucKey[*]

Das Schlüsselmaterial.

Wenn AlgorithmId auf DOT11_CIPHER_ALGO_TKIP festgelegt ist, definiert das ucKey-Array das Schlüsselmaterial über die DOT11_KEY_ALGO_TKIP_MIC-Struktur .

Wenn AlgorithmId auf DOT11_CIPHER_ALGO_CCMP festgelegt ist, definiert das ucKey-Array das Schlüsselmaterial über die DOT11_KEY_ALGO_CCMP-Struktur .

Wenn AlgorithmId auf DOT11_CIPHER_ALGO_BIP festgelegt ist, definiert das ucKey-Array das Schlüsselmaterial über die DOT11_KEY_ALGO_BIP-Struktur .

ucKey[1]

Das Schlüsselmaterial.

Wenn AlgorithmId auf DOT11_CIPHER_ALGO_TKIP festgelegt ist, definiert das ucKey-Array das Schlüsselmaterial über die DOT11_KEY_ALGO_TKIP_MIC-Struktur .

Wenn AlgorithmId auf DOT11_CIPHER_ALGO_CCMP festgelegt ist, definiert das ucKey-Array das Schlüsselmaterial über die DOT11_KEY_ALGO_CCMP-Struktur .

Wenn AlgorithmId auf DOT11_CIPHER_ALGO_BIP festgelegt ist, definiert das ucKey-Array das Schlüsselmaterial über die DOT11_KEY_ALGO_BIP-Struktur .

Hinweise

Wenn das bDelete-ElementTRUE ist, sind die folgenden Member ungültig und müssen ignoriert werden:

bStatic
usKeyLength
ucKey

Anforderungen

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