DOT11_CIPHER_DEFAULT_KEY_VALUE Struktur (windot11.h)

Artikel
02/07/2025

Wichtig

WiFiCx- ist das neue Wi-Fi Treibermodell, das in Windows 11 veröffentlicht wurde. Es wird empfohlen, wiFiCx zu verwenden, um die neuesten Features nutzen zu können. Das WDI-Treibermodell befindet sich jetzt im Wartungsmodus und erhält nur Korrekturen mit hoher Priorität.

Die DOT11_CIPHER_DEFAULT_KEY_VALUE-Struktur definiert einen Standardchiffreschlüssel oder einen Standardchiffreschlüssel pro Station, der den Schlüsseltabellen auf der Station 802.11 hinzugefügt oder 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;

Angehörige

Header

Der Typ, die Überarbeitung und die Größe der DOT11_CIPHER_DEFAULT_KEY_VALUE Struktur. Dieses Element ist als NDIS_OBJECT_HEADER Struktur formatiert.

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

Art

Dieses Element muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.

Revision

Dieses Element muss auf DOT11_CIPHER_DEFAULT_KEY_VALUE_REVISION_1 festgelegt werden.

Größe

Dieses Element muss auf sizeof(DOT11_CIPHER_DEFAULT_KEY_VALUE)festgelegt werden.

Weitere Informationen zu diesen Mitgliedern finden Sie unter NDIS_OBJECT_HEADER.

uKeyIndex

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

Für Standardalgorithmen 802.11 muss uKeyIndex- von 0 bis 3 sein. Für einen von einem IHV entwickelten Chiffrealgorithmus können uKeyIndex- beliebige Werte innerhalb des durch die IHV definierten Bereichs sein.

Für BIP-uKeyIndex- muss 4 oder 5 sein.

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

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 dieses Element ignorieren, wenn bDelete-TRUE-ist.

MacAddr

Die Mac-Adresse (Media Access Control), die die Standardschlüsseltabelle identifiziert, um den Schlüssel hinzuzufügen oder zu entfernen.

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

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

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

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

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

bDelete

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

Wenn dieser Wert auf TRUE-festgelegt ist, muss der Miniporttreiber die Standardtaste löschen, auf die von uKeyIndex-verwiesen wird. Wenn dieser Wert auf FALSE-festgelegt ist, muss der Miniporttreiber die Standardtaste hinzufügen oder aktualisieren, auf die von uKeyIndex- verwiesen wird.

bStatic

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

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

Trennt sich vom Standarddienstsatz (BSS)-Netzwerk.
Führt ein Roaming in ein neues BSS-Netzwerk durch.
Stellt eine Erneute Verbindung mit demselben BSS-Netzwerk her.

Wenn dieser Wert auf TRUEfestgelegt ist, darf der von uKeyIndex- referenzierte Standardschlüssel nicht gelöscht werden, es sei denn, er lautet:

Explizit gelöscht über eine Satzanforderung von OID_DOT11_CIPHER_DEFAULT_KEY.
Implizit durch eine Methodenanforderung von OID_DOT11_RESET_REQUESTgelöscht.

usKeyLength

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

ucKey[*]

Das Schlüsselmaterial.

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

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

Wenn AlgorithmId- auf DOT11_CIPHER_ALGO_BIPfestgelegt 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_TKIPfestgelegt ist, definiert das ucKey Array das Schlüsselmaterial über die DOT11_KEY_ALGO_TKIP_MIC-Struktur.

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

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