structure DOT11_CIPHER_KEY_MAPPING_KEY_VALUE (windot11.h)

Article
02/07/2025

Important

WiFiCx est le nouveau modèle de pilote Wi-Fi publié dans Windows 11. Nous vous recommandons d’utiliser WiFiCx pour tirer parti des dernières fonctionnalités. Le modèle de pilote WDI est désormais en mode maintenance et ne reçoit que des correctifs de priorité élevée.

La structure DOT11_CIPHER_KEY_MAPPING_KEY_VALUE définit une clé de chiffrement de mappage de clé qui sera ajoutée ou supprimée des tables de clés sur la station 802.11. Pour plus d’informations sur ce type de clé de chiffrement, consultez 802.11 Types de clés de chiffrement.

Syntaxe

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;

Membres

PeerMacAddr

Adresse MAC de l’homologue. L’homologue est un point d’accès (AP) (pour les réseaux BSS d’infrastructure) ou une station homologue (pour les réseaux BSS indépendants) avec laquelle la station 802.11 est associée.

Ce membre est utilisé pour identifier de manière unique une entrée de clé. Pour les algorithmes de chiffrement 802.11 standard, le système d’exploitation identifie l’homologue via l’adresse MAC de l’homologue. Pour les algorithmes de chiffrement propriétaires développés par un fournisseur de matériel indépendant (IHV), l’IHV peut utiliser n’importe quelle méthode pour identifier une entrée de clé.

Lorsque la carte réseau est en mode OP De point d’accès extensible (ExtAP), PeerMacAddr doit avoir une valeur unique.

AlgorithmId

Valeur de l’algorithme de chiffrement qui utilise cette clé. Pour plus d’informations sur les valeurs d’énumérateur pour les algorithmes de chiffrement, consultez DOT11_CIPHER_ALGORITHM.

Direction

Ce membre spécifie si la station 802.11 utilise la clé pour recevoir ou transmettre des paquets. Le type de données de ce membre est l’énumération DOT11_DIRECTION.

bDelete

Si la valeur est TRUE, le pilote miniport doit supprimer la clé référencée par PeerMacAddr et Direction. Si la valeur est FALSE, le pilote miniport doit ajouter ou mettre à jour la clé référencée par PeerMacAddr et Direction.

bStatic

Valeur booléenne qui spécifie si le pilote miniport doit supprimer la clé par défaut après une opération de connexion ou d’itinérance.

Si la valeur est FALSE, le pilote miniport doit supprimer la clé par défaut référencée par uKeyIndex chaque fois que :

La station 802.11 se déconnecte du réseau BSS.
La station homologue se déconnecte du réseau BSS.
La station 802.11 se reconnecte au même réseau BSS.

Si la valeur est TRUE, la clé par défaut référencée par uKeyIndex ne doit pas être supprimée, sauf s’il s’agit de :

Suppression explicite par le biais d’une demande de jeu de OID_DOT11_CIPHER_KEY_MAPPING_KEY.
Suppression implicite par le biais d’une requête de méthode de OID_DOT11_RESET_REQUEST.

usKeyLength

Longueur, en octets, du matériau de clé dans le tableau ucKey.

ucKey[*]

Matériau clé.

Si AlgorithmId est défini sur DOT11_CIPHER_ALGO_TKIP, le tableau ucKey définit le matériau de clé via le structure DOT11_KEY_ALGO_TKIP_MIC.

Si ' AlgorithmId est défini sur DOT11_CIPHER_ALGO_CCMP, le tableau ucKey définit le matériau de clé par le biais du tableau structure DOT11_KEY_ALGO_CCMP.

ucKey[1]

Matériau clé.

Si AlgorithmId est défini sur DOT11_CIPHER_ALGO_TKIP, le tableau ucKey définit le matériau de clé via le structure DOT11_KEY_ALGO_TKIP_MIC.

Si ' AlgorithmId est défini sur DOT11_CIPHER_ALGO_CCMP, le tableau ucKey définit le matériau de clé par le biais du tableau structure DOT11_KEY_ALGO_CCMP.

Remarques

Le pilote miniport Natif 802.11 identifie de manière unique les clés de mappage de clés via les membres PeerMacAddr et Direction. Quand OID_DOT11_CIPHER_KEY_MAPPING_KEY est définie, le pilote miniport peut modifier ou supprimer une clé existante uniquement si les valeurs des PeerMacAddr et Direction membres de la demande définie correspondent aux membres de la clé existante.

Si le membre bDelete est TRUE, les membres suivants ne sont pas valides et doivent être ignorés :

bStatic
usKeyLength
ucKey

Exigences

Exigence	Valeur
client minimum pris en charge	Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows.
d’en-tête	windot11.h (include Ndis.h)