estructura DOT11_CIPHER_KEY_MAPPING_KEY_VALUE (windot11.h)

Artículo
03/05/2024

Importante La interfaz LAN inalámbrica nativa 802.11 está en desuso en Windows 10 y versiones posteriores. En su lugar, use la interfaz del controlador de dispositivo WLAN (WDI). Para obtener más información sobre WDI, consulta Modelo de controlador de Windows universal WLAN.

La estructura DOT11_CIPHER_KEY_MAPPING_KEY_VALUE define una clave de cifrado de asignación de claves que se agregará o eliminará de las tablas de claves de la estación 802.11. Para obtener más información sobre este tipo de clave de cifrado, vea 802.11 Tipos de clave de cifrado.

Sintaxis

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;

Miembros

PeerMacAddr

Dirección MAC del mismo nivel. El mismo nivel es un punto de acceso (AP) (para redes BSS de infraestructura) o una estación del mismo nivel (para redes BSS independientes) con la que está asociada la estación 802.11.

Este miembro se usa para identificar de forma única una entrada de clave. Para los algoritmos de cifrado estándar 802.11, el sistema operativo identificará el sistema operativo a través de la dirección MAC del mismo nivel. En el caso de los algoritmos de cifrado propietarios desarrollados por un proveedor de hardware independiente (IHV), el IHV puede usar cualquier método para identificar una entrada de clave.

Cuando la NIC está en el modo op de punto de acceso extensible (ExtAP), PeerMacAddr debe tener un valor único.

AlgorithmId

Valor del algoritmo de cifrado que usa esta clave. Para obtener más información sobre los valores del enumerador para algoritmos de cifrado, consulte DOT11_CIPHER_ALGORITHM.

Direction

Este miembro especifica si la estación 802.11 usa la clave para recibir o transmitir paquetes. El tipo de datos de este miembro es la enumeración DOT11_DIRECTION .

bDelete

Si se establece en TRUE, el controlador de minipuerto debe eliminar la clave a la que hace referencia PeerMacAddr y Direction . Si se establece en FALSE, el controlador de minipuerto debe agregar o actualizar la clave a la que hace referencia PeerMacAddr y Direction .

bStatic

Valor booleano que especifica si el controlador de minipuerto debe eliminar la clave predeterminada después de una operación de conexión o itinerancia.

Si se establece en FALSE, el controlador de minipuerto debe eliminar la clave predeterminada a la que hace referencia uKeyIndex siempre que:

La estación 802.11 se desconecta de la red BSS.
La estación del mismo nivel se desconecta de la red BSS.
La estación 802.11 se vuelve a conectar a la misma red BSS.

Si se establece en TRUE, la clave predeterminada a la que hace referencia uKeyIndex no se debe eliminar a menos que sea:

Se eliminó explícitamente a través de una solicitud de conjunto de OID_DOT11_CIPHER_KEY_MAPPING_KEY.
Se elimina implícitamente a través de una solicitud de método de OID_DOT11_RESET_REQUEST.

usKeyLength

Longitud, en bytes, del material de clave en la matriz ucKey .

ucKey[*]

Material clave.

Si AlgorithmId se establece en DOT11_CIPHER_ALGO_TKIP, la matriz ucKey define el material de clave a través de . DOT11_KEY_ALGO_TKIP_MIC estructura.

Si AlgorithmId se establece en DOT11_CIPHER_ALGO_CCMP, la matriz ucKey define el material de clave a través de . DOT11_KEY_ALGO_CCMP estructura.

ucKey[1]

Material clave.

Si AlgorithmId se establece en DOT11_CIPHER_ALGO_TKIP, la matriz ucKey define el material de clave a través de . DOT11_KEY_ALGO_TKIP_MIC estructura.

Si AlgorithmId se establece en DOT11_CIPHER_ALGO_CCMP, la matriz ucKey define el material de clave a través de . DOT11_KEY_ALGO_CCMP estructura.

Comentarios

El controlador de minipuerto Native 802.11 identifica de forma única las claves de asignación de claves a través de los miembros PeerMacAddr y Direction . Si el cliente de OID_DOT11_CIPHER_KEY_MAPPING_KEY se establece, el controlador de minipuerto solo puede modificar o eliminar una clave existente si los valores de los miembros PeerMacAddr y Direction de la solicitud set coinciden con los miembros de la clave existente.

Si el miembro bDelete es TRUE, los miembros siguientes no son válidos y deben omitirse:

bStatic
usKeyLength
ucKey

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Encabezado	windot11.h (incluye Ndis.h)