structure DOT11_CIPHER_KEY_MAPPING_KEY_VALUE (windot11.h)

Article
08/08/2023

Important L’interface LAN sans fil Native 802.11 est déconseillée dans Windows 10 et versions ultérieures. Utilisez plutôt l’interface WDI (WLAN Device Driver Interface). Pour plus d’informations sur WDI, consultez Modèle de pilote Windows universel WLAN.

La structure DOT11_CIPHER_KEY_MAPPING_KEY_VALUE définit une clé de chiffrement de mappage de clés 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 Types de clés de chiffrement 802.11.

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) auquel 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 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 les paquets de réception ou de transmission. Le type de données de ce membre est l’énumération DOT11_DIRECTION .

bDelete

S’il est défini sur 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.

S’il est défini sur 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 si elle est :

Supprimé explicitement par le biais d’une demande de jeu de OID_DOT11_CIPHER_KEY_MAPPING_KEY.
Supprimé implicitement par le biais d’une demande de méthode de OID_DOT11_RESET_REQUEST.

usKeyLength

Longueur, en octets, du matériau 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 clé via le DOT11_KEY_ALGO_TKIP_MIC structure.

Si AlgorithmId est défini sur DOT11_CIPHER_ALGO_CCMP, le tableau ucKey définit le matériau clé via le DOT11_KEY_ALGO_CCMP structure.

ucKey[1]

Matériau clé.

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

Si AlgorithmId est défini sur DOT11_CIPHER_ALGO_CCMP, le tableau ucKey définit le matériau clé via le DOT11_KEY_ALGO_CCMP structure.

Remarques

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

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

bStatic
usKeyLength
ucKey

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.
En-tête	windot11.h (inclure Ndis.h)