DOT11_CIPHER_KEY_MAPPING_KEY_VALUE-Struktur (windot11.h)
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.
- 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) |