struttura DOT11_CIPHER_KEY_MAPPING_KEY_VALUE (windot11.h)

Articolo
02/27/2024

Importante L'interfaccia LAN wireless native 802.11 è deprecata in Windows 10 e versioni successive. Usare invece l'interfaccia WDI (WLAN Device Driver Interface). Per altre informazioni su WDI, vedere Modello di driver WINDOWS universale WLAN.

La struttura DOT11_CIPHER_KEY_MAPPING_KEY_VALUE definisce una chiave di crittografia di mapping delle chiavi che verrà aggiunta o eliminata dalle tabelle delle chiavi nella 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;

Members

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 Extensible Access Point (ExtAP), 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 peer station 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 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 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.

Commenti

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

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

bStatic
usKeyLength
ucKey

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	windot11.h (include Ndis.h)