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