estrutura DOT11_CIPHER_KEY_MAPPING_KEY_VALUE (windot11.h)
Importante
WiFiCx é o novo modelo de driver Wi-Fi lançado no Windows 11. Recomendamos que você use o WiFiCx para aproveitar os recursos mais recentes. O modelo de driver WDI agora está no modo de manutenção e receberá apenas correções de alta prioridade.
A estrutura DOT11_CIPHER_KEY_MAPPING_KEY_VALUE define uma chave de criptografia de mapeamento de chave que será adicionada ou excluída das tabelas de chaves na estação 802.11. Para obter mais informações sobre esse tipo de chave de criptografia, consulte tipos de chave de criptografia 802.11.
Sintaxe
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;
Membros
PeerMacAddr
Endereço MAC do par. O par é um AP (ponto de acesso) (para redes BSS de infraestrutura) ou uma estação par (para redes BSS independentes) com a qual a estação 802.11 está associada.
Esse membro é usado para identificar exclusivamente uma entrada de chave. Para os algoritmos de criptografia padrão 802.11, o sistema operacional identificará o par por meio do endereço MAC do par. Para algoritmos de criptografia proprietários desenvolvidos por um IHV (fornecedor de hardware independente), o IHV pode usar qualquer método para identificar uma entrada de chave.
Quando a NIC está no modo OP do Ponto de Acesso Extensível (ExtAP), PeerMacAddr deve ter um valor exclusivo.
AlgorithmId
O valor do algoritmo de criptografia que usa essa chave. Para obter mais informações sobre valores de enumerador para algoritmos de criptografia, consulte DOT11_CIPHER_ALGORITHM.
Direction
Este membro especifica se a estação 802.11 usa a chave para receber ou transmitir pacotes. O tipo de dados desse membro é a enumeração DOT11_DIRECTION.
bDelete
Se definido como TRUE, o driver de miniporto deverá excluir a chave referenciada por PeerMacAddr e Direction . Se definido como FALSE, o driver de miniporto deverá adicionar ou atualizar a chave referenciada por PeerMacAddr e Direction.
bStatic
Um valor booliano que especifica se o driver de miniporto deve excluir a chave padrão após uma conexão ou operação de roaming.
Se definido como FALSE, o driver de miniporto deverá excluir a chave padrão referenciada por uKeyIndex sempre que:
- A estação 802.11 se desconecta da rede BSS.
- A estação par se desconecta da rede BSS.
- A estação 802.11 se reconecta à mesma rede BSS.
- Explicitamente excluído por meio de uma solicitação de conjunto de OID_DOT11_CIPHER_KEY_MAPPING_KEY.
- Excluído implicitamente por meio de uma solicitação de método de OID_DOT11_RESET_REQUEST.
usKeyLength
O comprimento, em bytes, do material de chave na matriz de ucKey.
ucKey[*]
O material da chave.
Se AlgorithmId estiver definida como DOT11_CIPHER_ALGO_TKIP, a matriz ucKey definirá o material da chave por meio do DOT11_KEY_ALGO_TKIP_MIC estrutura.
Se AlgorithmId estiver definido como DOT11_CIPHER_ALGO_CCMP, a matriz ucKey definirá o material da chave por meio do DOT11_KEY_ALGO_CCMP estrutura.
ucKey[1]
O material da chave.
Se AlgorithmId estiver definida como DOT11_CIPHER_ALGO_TKIP, a matriz ucKey definirá o material da chave por meio do DOT11_KEY_ALGO_TKIP_MIC estrutura.
Se AlgorithmId estiver definido como DOT11_CIPHER_ALGO_CCMP, a matriz ucKey definirá o material da chave por meio do DOT11_KEY_ALGO_CCMP estrutura.
Observações
O driver de miniporto Native 802.11 identifica exclusivamente as chaves de mapeamento de chave por meio dos membros PeerMacAddr e Direction. Quando o OID_DOT11_CIPHER_KEY_MAPPING_KEY estiver definido, o driver de miniporto poderá modificar ou excluir uma chave existente somente se os valores do PeerMacAddr e Direction membros da solicitação definida corresponderem aos membros da chave existente.
Se o membro bDelete for verdadeiro, os seguintes membros não serão válidos e deverão ser ignorados:
- bStatic
- usKeyLength
- ucKey
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| cabeçalho | windot11.h (inclua Ndis.h) |