Compartilhar via


estrutura DOT11_CIPHER_KEY_MAPPING_KEY_VALUE (windot11.h)

Importante A interface lan sem fio Native 802.11 foi preterida no Windows 10 e posterior. Em vez disso, use a WDI (Interface de Driver de Dispositivo) da WLAN. Para obter mais informações sobre o WDI, consulte Modelo de driver universal do Windows da WLAN.
 
A estrutura DOT11_CIPHER_KEY_MAPPING_KEY_VALUE define uma chave de codificação 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 independente de hardware), 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

Esse 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.
Se definida como TRUE, a chave padrão referenciada por uKeyIndex não deverá ser excluída, a menos que seja:

usKeyLength

O comprimento, em bytes, do material de chave na matriz ucKey .

ucKey[*]

O material da chave.

Se AlgorithmId estiver definido 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 definido 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.

Comentários

O driver de miniporto Native 802.11 identifica exclusivamente as chaves de mapeamento de chave por meio dos membros PeerMacAddr e Direction . Quando o cliente do OID_DOT11_CIPHER_KEY_MAPPING_KEY estiver definido, o driver de miniporto poderá modificar ou excluir uma chave existente somente se os valores dos membros PeerMacAddr e Direction da solicitação set corresponderem aos membros da chave existente.

Se o membro bDelete for TRUE, os seguintes membros não serão válidos e deverão ser ignorados:

  • bStatic
  • usKeyLength
  • ucKey

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Cabeçalho windot11.h (inclua Ndis.h)

Confira também

OID_DOT11_CIPHER_KEY_MAPPING_KEY

DOT11_KEY_ALGO_TKIP_MIC

OID_DOT11_RESET_REQUEST

DOT11_CIPHER_ALGORITHM

OID_DOT11_DESIRED_BSS_TYPE

DOT11_KEY_ALGO_CCMP

DOT11_DIRECTION