estructura DOT11_CIPHER_KEY_MAPPING_KEY_VALUE (windot11.h)
Importante
WiFiCx es el nuevo modelo de controlador de Wi-Fi lanzado en Windows 11. Se recomienda usar WiFiCx para aprovechar las características más recientes. El modelo de controlador WDI ahora está en modo de mantenimiento y solo recibirá correcciones de prioridad alta.
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 las 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. Para 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 los 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 miniport debe eliminar la clave a la que hace referencia PeerMacAddr y Direction . Si se establece en FALSE, el controlador de miniport debe agregar o actualizar la clave a la que hace referencia PeerMacAddr y Direction .
bStatic
Valor booleano que especifica si el controlador de miniport debe eliminar la clave predeterminada después de una operación de conexión o itinerancia.
Si se establece en FALSE, el controlador de miniport 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.
- Se eliminó explícitamente a través de una solicitud establecida de OID_DOT11_CIPHER_KEY_MAPPING_KEY.
- Se eliminó implícitamente a través de una solicitud de método de OID_DOT11_RESET_REQUEST.
usKeyLength
Longitud, en bytes, del material de clave de 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 de ucKey define el material de clave a través de . estructura DOT11_KEY_ALGO_CCMP.
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 de ucKey define el material de clave a través de . estructura DOT11_KEY_ALGO_CCMP.
Observaciones
El controlador de miniporte Native 802.11 identifica de forma única las claves de asignación de claves a través de los miembros de PeerMacAddr y Direction. Cuándo OID_DOT11_CIPHER_KEY_MAPPING_KEY se establece, el controlador de miniporte puede modificar o eliminar una clave existente solo si los valores de PeerMacAddr y Direction miembros 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| encabezado de | windot11.h (incluye Ndis.h) |