struttura DOT11_CIPHER_KEY_MAPPING_KEY_VALUE (windot11.h)

Articolo
02/07/2025

Importante

WiFiCx è il nuovo modello di driver Wi-Fi rilasciato in Windows 11. Ti consigliamo di usare WiFiCx per sfruttare le funzionalità più recenti. Il modello di driver WDI è ora in modalità di manutenzione e riceverà solo correzioni ad alta priorità.

La struttura DOT11_CIPHER_KEY_MAPPING_KEY_VALUE definisce una chiave di crittografia con mapping delle chiavi che verrà aggiunta o eliminata dalle tabelle chiave della stazione 802.11. Per altre informazioni su questo tipo di chiave di crittografia, vedere 802.11 Tipi di chiave di crittografia.

Sintassi

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;

Membri

PeerMacAddr

Indirizzo MAC del peer. Il peer è un punto di accesso (AP) (per le reti BSS dell'infrastruttura) o una stazione peer (per reti BSS indipendenti) con cui è associata la stazione 802.11.

Questo membro viene usato per identificare in modo univoco una voce di chiave. Per gli algoritmi di crittografia standard 802.11, il sistema operativo identificherà il peer tramite l'indirizzo MAC del peer. Per gli algoritmi di crittografia proprietari sviluppati da un fornitore di hardware indipendente (IHV), l'IHV può usare qualsiasi metodo per identificare una voce di chiave.

Quando la scheda di interfaccia di rete si trova nella modalità OP ExtAP (Extensible Access Point), PeerMacAddr deve avere un valore univoco.

AlgorithmId

Valore dell'algoritmo di crittografia che usa questa chiave. Per altre informazioni sui valori dell'enumeratore per gli algoritmi di crittografia, vedere DOT11_CIPHER_ALGORITHM.

Direction

Questo membro specifica se la stazione 802.11 utilizza la chiave per ricevere o trasmettere pacchetti. Il tipo di dati per questo membro è l'enumerazione DOT11_DIRECTION.

bDelete

Se impostato su TRUE, il driver miniport deve eliminare la chiave a cui fa riferimento PeerMacAddr e Direction . Se impostato su FALSE, il driver miniport deve aggiungere o aggiornare la chiave a cui fa riferimento PeerMacAddr e Direction .

bStatic

Valore booleano che specifica se il driver miniport deve eliminare la chiave predefinita dopo un'operazione di connessione o roaming.

Se impostato su FALSE, il driver miniport deve eliminare la chiave predefinita a cui fa riferimento uKeyIndex ogni volta che:

La stazione 802.11 si disconnette dalla rete BSS.
La stazione peer si disconnette dalla rete BSS.
La stazione 802.11 si riconnette alla stessa rete BSS.

Se impostato su TRUE, la chiave predefinita a cui fa riferimento uKeyIndex non deve essere eliminata a meno che non sia:

Eliminato in modo esplicito tramite una richiesta set di OID_DOT11_CIPHER_KEY_MAPPING_KEY.
Eliminato in modo implicito tramite una richiesta di metodo di OID_DOT11_RESET_REQUEST.

usKeyLength

Lunghezza, in byte, del materiale della chiave nella matrice ucKey.

ucKey[*]

Materiale della chiave.

Se AlgorithmId è impostato su DOT11_CIPHER_ALGO_TKIP, la matrice ucKey definisce il materiale della chiave tramite il DOT11_KEY_ALGO_TKIP_MIC struttura.

Se AlgorithmId è impostato su DOT11_CIPHER_ALGO_CCMP, la matrice ucKey definisce il materiale della chiave tramite DOT11_KEY_ALGO_CCMP struttura.

ucKey[1]

Materiale della chiave.

Se AlgorithmId è impostato su DOT11_CIPHER_ALGO_TKIP, la matrice ucKey definisce il materiale della chiave tramite il DOT11_KEY_ALGO_TKIP_MIC struttura.

Se AlgorithmId è impostato su DOT11_CIPHER_ALGO_CCMP, la matrice ucKey definisce il materiale della chiave tramite DOT11_KEY_ALGO_CCMP struttura.

Osservazioni

Il driver miniport nativo 802.11 identifica in modo univoco le chiavi di mapping delle chiavi tramite i membri PeerMacAddr e Direction. Quando l'oggetto OID_DOT11_CIPHER_KEY_MAPPING_KEY è impostato, il driver miniport può modificare o eliminare una chiave esistente solo se i valori del PeerMacAddr e Direction membri della richiesta impostata corrispondono ai membri della chiave esistente.

Se il membro bDelete è TRUE, i membri seguenti non sono validi e devono essere ignorati: