DOT11_CIPHER_KEY_MAPPING_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_KEY_MAPPING_KEY_VALUE-Struktur definiert einen Schlüssel für die Schlüsselzuordnung, der den Schlüsseltabellen auf der Station 802.11 hinzugefügt oder daraus gelöscht wird. Weitere Informationen zu diesem Chiffreschlüsseltyp finden Sie unter 802.11 Chiffreschlüsseltypen.

Syntax

typedef struct DOT11_CIPHER_KEY_MAPPING_KEY_VALUE {
  DOT11_MAC_ADDRESS      PeerMacAddr;
  DOT11_CIPHER_ALGORITHM AlgorithmId;
  DOT11_DIRECTION        Direction;
  BOOLEAN                bDelete;
  BOOLEAN                bStatic;
  USHORT                 usKeyLength;
  UCHAR                  ucKey[1];
} DOT11_CIPHER_KEY_MAPPING_KEY_VALUE, *PDOT11_CIPHER_KEY_MAPPING_KEY_VALUE;

Angehörige

PeerMacAddr

MAC-Adresse des Peers. Der Peer ist entweder ein Zugriffspunkt (AP) (für Infrastruktur-BSS-Netzwerke) oder Peerstation (für unabhängige BSS-Netzwerke), mit dem die Station 802.11 verknüpft ist.

Dieses Element wird verwendet, um einen Schlüsseleintrag eindeutig zu identifizieren. Für die Standardalgorithmen 802.11 identifiziert das Betriebssystem den Peer über die MAC-Adresse des Peers. Für proprietäre Verschlüsselungsalgorithmen, die von einem unabhängigen Hardwareanbieter (IHV) entwickelt wurden, kann das IHV jede Methode verwenden, um einen Schlüsseleintrag zu identifizieren.

Wenn sich die NIC im Extensible Access Point (ExtAP)-OP-Modus befindet, muss PeerMacAddr- einen eindeutigen Wert aufweisen.

AlgorithmId

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

Direction

Dieses Mitglied gibt an, ob die Station 802.11 den Schlüssel zum Empfangen oder Übertragen von Paketen verwendet. Der Datentyp für dieses Element ist die DOT11_DIRECTION Enumeration.

bDelete

Wenn dieser Wert auf TRUEfestgelegt ist, muss der Miniporttreiber den Schlüssel löschen, auf den PeerMacAddr und Direction verweist. Wenn dieser Wert auf FALSE-festgelegt ist, muss der Miniporttreiber den Schlüssel hinzufügen oder aktualisieren, auf den PeerMacAddr und Direction 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 die Standardtaste löschen, auf die von uKeyIndex verwiesen wird, wann immer:

Die Station 802.11 trennt sich vom BSS-Netzwerk.
Die Peerstation trennt sich vom BSS-Netzwerk.
Die Station 802.11 verbindet sich wieder mit demselben BSS-Netzwerk.

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_KEY_MAPPING_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 das DOT11_KEY_ALGO_TKIP_MIC Struktur.

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

ucKey[1]

Das Schlüsselmaterial.

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

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

Bemerkungen

Der Native 802.11-Miniporttreiber identifiziert Schlüsselzuordnungsschlüssel eindeutig über die PeerMacAddr- und Direction-Member. Wann OID_DOT11_CIPHER_KEY_MAPPING_KEY festgelegt ist, kann der Miniporttreiber einen vorhandenen Schlüssel nur ändern oder löschen, wenn die Werte der PeerMacAddr und Direction Member aus der set-Anforderung den Mitgliedern des vorhandenen Schlüssels entsprechen.

Wenn das bDelete Member TRUEist, sind die folgenden Elemente ungültig und müssen ignoriert werden:

bStatic
usKeyLength
ucKey-

Anforderungen

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