estrutura DOT11_AUTH_CIPHER_PAIR_LIST (windot11.h)
Sintaxe
typedef struct DOT11_AUTH_CIPHER_PAIR_LIST {
NDIS_OBJECT_HEADER Header;
ULONG uNumOfEntries;
ULONG uTotalNumOfEntries;
DOT11_AUTH_CIPHER_PAIR AuthCipherPairs[1];
} DOT11_AUTH_CIPHER_PAIR_LIST, *PDOT11_AUTH_CIPHER_PAIR_LIST;
Membros
Header
O tipo, a revisão e o tamanho da estrutura DOT11_AUTH_CIPHER_PAIR_LIST. Esse membro é formatado como uma estrutura NDIS_OBJECT_HEADER .
O driver de miniporte deve definir os membros de Cabeçalho para os seguintes valores:
Tipo
Esse membro deve ser definido como NDIS_OBJECT_TYPE_DEFAULT.
Revisão
Esse membro deve ser definido como DOT11_AUTH_CIPHER_PAIR_LIST_REVISION_1.
Tamanho
Esse membro deve ser definido como sizeof(DOT11_AUTH_CIPHER_PAIR_LIST).
Para obter mais informações sobre esses membros, consulte NDIS_OBJECT_HEADER.
uNumOfEntries
O número de entradas na matriz AuthCipherPairs .
uTotalNumOfEntries
O número máximo de entradas que a matriz AuthCipherPairs pode conter.
AuthCipherPairs[1]
A lista de DOT11_AUTH_CIPHER_PAIR estruturas.
Comentários
Um driver de miniporte retorna a estrutura DOT11_AUTH_CIPHER_PAIR_LIST quando consultado por um OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR ou OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.
Quando esses OIDs são consultados, o driver de miniporto deve verificar se o membro InformationBuffer do parâmetro OidRequest da função MiniportOidRequest é grande o suficiente para retornar toda a estrutura DOT11_AUTH_CIPHER_PAIR_LIST, incluindo todas as entradas na matriz AuthCipherPairs. O valor do membro InformationBufferLength do parâmetro OidRequest determina o que o driver de miniporto deve fazer, como mostra a lista a seguir:
-
Se o valor do membro InformationBufferLength for menor que o comprimento, em bytes, de toda a estrutura DOT11_AUTH_CIPHER_PAIR_LIST, o driver de miniporto deverá fazer o seguinte:
- Para o parâmetro OidRequest , defina o membro BytesWritten como zero e o membro BytesNeeded para o comprimento, em bytes, de toda a estrutura DOT11_AUTH_CIPHER_PAIR_LIST.
- Falha na solicitação de consulta retornando NDIS_STATUS_BUFFER_OVERFLOW de sua função MiniportOidRequest .
-
Se o valor do membro InformationBufferLength for maior ou igual ao comprimento, em bytes, de toda a estrutura DOT11_AUTH_CIPHER_PAIR_LIST, o driver de miniporto deverá fazer o seguinte para concluir uma solicitação de consulta bem-sucedida:
- Para a estrutura DOT11_AUTH_CIPHER_PAIR_LIST, defina os membros uNumOfEntries e uTotalNumOfEntries como o número total de entradas na matriz AuthCipherPairs .
- Para o parâmetro OidRequest , defina o membro BytesNeeded como zero e o membro BytesWritten para o comprimento, em bytes, de toda a estrutura DOT11_AUTH_CIPHER_PAIR_LIST. O driver de miniporte também deve copiar toda a estrutura de DOT11_AUTH_CIPHER_PAIR_LIST para o membro do InformationBuffer .
- Retorne NDIS_STATUS_SUCCESS de sua função MiniportOidRequest .
Se o WPS estiver habilitado em uma NIC que esteja operando no modo AP extensível, o driver de miniporto deverá permitir que as estações de pares se associem à AP Extensível usando algoritmos de Autenticação do Sistema Aberto ou WEP (Privacidade Equivalente Com Fio), independentemente dos algoritmos de autorização e codificação habilitados. Para obter mais informações sobre wps e AP extensível, consulte OID_DOT11_WPS_ENABLED.
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) |