estrutura DOT11_CIPHER_KEY_MAPPING_KEY_VALUE (windot11.h)
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.
- Explicitamente excluído por meio de uma solicitação definida 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 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) |