struttura DOT11_CIPHER_DEFAULT_KEY_VALUE (windot11.h)

Articolo
08/08/2023

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_DEFAULT_KEY_VALUE definisce una chiave di crittografia predefinita o una chiave di crittografia predefinita per stazione che verrà aggiunta o eliminata dalle tabelle delle chiavi nella stazione 802.11. Per altre informazioni su questi tipi di chiave di crittografia, vedere 802.11 Tipi di chiave di crittografia.

Sintassi

typedef struct DOT11_CIPHER_DEFAULT_KEY_VALUE {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  uKeyIndex;
  DOT11_CIPHER_ALGORITHM AlgorithmId;
  DOT11_MAC_ADDRESS      MacAddr;
  BOOLEAN                bDelete;
  BOOLEAN                bStatic;
  USHORT                 usKeyLength;
  UCHAR                  ucKey[1];
} DOT11_CIPHER_DEFAULT_KEY_VALUE, *PDOT11_CIPHER_DEFAULT_KEY_VALUE;

Members

Header

Tipo, revisione e dimensioni della struttura DOT11_CIPHER_DEFAULT_KEY_VALUE. Questo membro viene formattato come struttura NDIS_OBJECT_HEADER .

Il driver miniport deve impostare i membri di Header sui valori seguenti:

Tipo

Questo membro deve essere impostato su NDIS_OBJECT_TYPE_DEFAULT.

Revisione

Questo membro deve essere impostato su DOT11_CIPHER_DEFAULT_KEY_VALUE_REVISION_1.

Dimensione

Questo membro deve essere impostato su sizeof(DOT11_CIPHER_DEFAULT_KEY_VALUE).

Per altre informazioni su questi membri, vedere NDIS_OBJECT_HEADER.

uKeyIndex

Indice della chiave nella matrice di chiavi predefinita della stazione 802.11.

Per gli algoritmi di crittografia standard 802.11, uKeyIndex deve essere compreso tra 0 e 3. Per un algoritmo di crittografia sviluppato da un IHV, uKeyIndex può essere qualsiasi valore all'interno dell'intervallo definito dall'IHV.

Per BIP uKeyIndex deve essere 4 o 5.

Lo standard IEEE 802.11-2012 definisce i valori di indice chiave predefiniti compresi tra 1 e 4. Il valore x specificato da questo membro esegue il mapping all'indice di chiave predefinito 802.11 (x + 1).

AlgorithmId

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

Per BIP, questo valore deve essere impostato su DOT11_CIPHER_ALGO_BIP per pre-impostare il numero di pacchetto IGTK iniziale.

Il driver miniport deve ignorare questo membro se bDelete è TRUE.

MacAddr

Indirizzo MAC (Media Access Control), che identifica la tabella delle chiavi predefinita per aggiungere o rimuovere la chiave.

Se l'oggetto dot11DesiredBSSType Management Information Base (MIB) è impostato su dot11_BSS_type_infrastructure, la stazione 802.11 aggiunge o rimuove la chiave dalla tabella delle chiavi predefinita indipendentemente dal valore del membro MacAddr . Se la chiave viene ottenuta dinamicamente dal punto di accesso (AP) a cui è associata la stazione, il membro MacAddr conterrà l'indirizzo MAC dell'AP. In caso contrario, MacAddr avrà un valore di 0x000000000000.

Se l'oggetto dot11DesiredBSSType Management Information Base (MIB) è impostato su dot11_BSS_type_independent, la stazione 802.11 deve aggiungere o rimuovere la chiave nel modo seguente:

Se il valore di questo membro è 0x000000000000, la stazione 802.11 aggiunge o rimuove la chiave dalla tabella chiave predefinita. Quando la scheda di interfaccia di rete si trova nella modalità OP Extensible Access Point (ExtAP), questo valore è zero.
Se il valore di questo membro è un indirizzo MAC unicast valido, la stazione 802.11 aggiunge o rimuove la chiave dalla tabella chiave predefinita per ogni stazione per la stazione peer in una rete BSS (IBSS) indipendente con un indirizzo MAC uguale al valore di MacAddr .

Se non esiste una tabella chiave predefinita per ogni stazione per il valore di MacAddr, la stazione 802.11 deve utilizzare qualsiasi tabella chiave predefinita non utilizzata per stazione.

Per altre informazioni sull'oggetto MIB dot11DesiredBSSType , vedere OID_DOT11_DESIRED_BSS_TYPE.

bDelete

Valore booleano che specifica se il driver miniport deve eliminare la chiave predefinita.

Se impostato su TRUE, il driver miniport deve eliminare la chiave predefinita a cui fa riferimento uKeyIndex. Se è impostata su FALSE, il driver miniport deve aggiungere o aggiornare la chiave predefinita a cui fa riferimento uKeyIndex .

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 (Basic Service Set).
Esegue il roaming in una nuova rete BSS.
Riconnettersi 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:

Eliminata in modo esplicito tramite una richiesta set di OID_DOT11_CIPHER_DEFAULT_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 la struttura DOT11_KEY_ALGO_TKIP_MIC .

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

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

ucKey[1]

Materiale della chiave.

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

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

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