DOT11_CIPHER_KEY_MAPPING_KEY_VALUE-Struktur (windot11.h)

Artikel
03/05/2024

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_CIPHER_KEY_MAPPING_KEY_VALUE-Struktur definiert einen Schlüsselzuordnungsschlüssel, der den Schlüsseltabellen auf der Station 802.11 hinzugefügt oder aus diesen gelöscht wird. Weitere Informationen zu diesem Verschlüsselungsschlüsseltyp finden Sie unter 802.11 Verschlüsselungsschlü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;

Member

PeerMacAddr

MAC-Adresse des Peers. Der Peer ist entweder ein Access Point (AP) (für BSS-Infrastrukturnetzwerke) oder eine Peerstation (für unabhängige BSS-Netzwerke), der die 802.11-Station zugeordnet ist.

Dieser Member wird verwendet, um einen Schlüsseleintrag eindeutig zu identifizieren. Für die Standardverschlüsselungsalgorithmen 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 (Independent Hardware Vendor, IHV) entwickelt wurden, kann der IHV eine beliebige Methode verwenden, um einen Schlüsseleintrag zu identifizieren.

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

AlgorithmId

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

Direction

Dieses Element 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 auf TRUE festgelegt ist, muss der Miniporttreiber den Schlüssel löschen, auf den von PeerMacAddr und Direction verwiesen wird. Wenn auf FALSE festgelegt ist, muss der Miniporttreiber den Schlüssel hinzufügen oder aktualisieren, auf den von PeerMacAddr und Direction verwiesen wird.

bStatic

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

Wenn auf FALSE festgelegt ist, muss der Miniporttreiber den Standardschlüssel löschen, auf den von uKeyIndex verwiesen wird, wann immer:

Die Station 802.11 trennt sich vom BSS-Netzwerk.
Die Peerstation wird vom BSS-Netzwerk getrennt.
Die Station 802.11 stellt wieder eine Verbindung mit demselben BSS-Netzwerk her.

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

Explizit gelöscht durch eine Setanforderung von OID_DOT11_CIPHER_KEY_MAPPING_KEY.
Implizit gelöscht durch eine Methodenanforderung von OID_DOT11_RESET_REQUEST.

usKeyLength

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

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.

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.

Hinweise

Der Native 802.11-Miniporttreiber identifiziert schlüsselzuordnungsschlüssel eindeutig über die Elemente PeerMacAddr und Direction . Bei der Installation des OID_DOT11_CIPHER_KEY_MAPPING_KEY festgelegt ist, kann der Miniporttreiber einen vorhandenen Schlüssel nur ändern oder löschen, wenn die Werte der Elemente PeerMacAddr und Direction aus der Setanforderung mit den Membern des vorhandenen Schlüssels übereinstimmen.

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 Vista und höheren Versionen der Windows-Betriebssysteme.
Kopfzeile	windot11.h (include Ndis.h)