estructura DOT11_AUTH_CIPHER_PAIR_LIST (windot11.h)
Sintaxis
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;
Miembros
Header
Tipo, revisión y tamaño de la estructura DOT11_AUTH_CIPHER_PAIR_LIST. Este miembro tiene el formato de estructura NDIS_OBJECT_HEADER .
El controlador de minipuerto debe establecer los miembros de Header en los valores siguientes:
Tipo
Este miembro debe establecerse en NDIS_OBJECT_TYPE_DEFAULT.
Revisión
Este miembro debe establecerse en DOT11_AUTH_CIPHER_PAIR_LIST_REVISION_1.
Size
Este miembro debe establecerse sizeof(DOT11_AUTH_CIPHER_PAIR_LIST)en .
Para obtener más información sobre estos miembros, vea NDIS_OBJECT_HEADER.
uNumOfEntries
Número de entradas de la matriz AuthCipherPairs .
uTotalNumOfEntries
Número máximo de entradas que puede contener la matriz AuthCipherPairs .
AuthCipherPairs[1]
Lista de elementos DOT11_AUTH_CIPHER_PAIR estructuras.
Comentarios
Un controlador de minipuerto devuelve la estructura DOT11_AUTH_CIPHER_PAIR_LIST cuando se consulta mediante cualquiera de las dos OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR o OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.
Cuando se consultan estos OID, el controlador de minipuerto debe comprobar que el miembro InformationBuffer del parámetro OidRequest de la función MiniportOidRequest es lo suficientemente grande como para devolver toda la estructura DOT11_AUTH_CIPHER_PAIR_LIST, incluidas todas las entradas de la matriz AuthCipherPairs. El valor del miembro InformationBufferLength del parámetro OidRequest determina lo que debe hacer el controlador de minipuerto, como se muestra en la lista siguiente:
-
Si el valor del miembro InformationBufferLength es menor que la longitud, en bytes, de toda la estructura de DOT11_AUTH_CIPHER_PAIR_LIST, el controlador de miniporte debe hacer lo siguiente:
- Para el parámetro OidRequest , establezca el miembro BytesWritten en cero y el miembro BytesNeeded en la longitud, en bytes, de toda la estructura DOT11_AUTH_CIPHER_PAIR_LIST.
- Produzca un error en la solicitud de consulta devolviendo NDIS_STATUS_BUFFER_OVERFLOW de su función MiniportOidRequest .
-
Si el valor del miembro InformationBufferLength es mayor o igual que la longitud, en bytes, de toda la estructura de DOT11_AUTH_CIPHER_PAIR_LIST, el controlador de minipuerto debe hacer lo siguiente para completar una solicitud de consulta correcta:
- Para la estructura DOT11_AUTH_CIPHER_PAIR_LIST, establezca los miembros uNumOfEntries y uTotalNumOfEntries en el número total de entradas de la matriz AuthCipherPairs .
- Para el parámetro OidRequest , establezca el miembro BytesNeeded en cero y el miembro BytesWritten en la longitud, en bytes, de toda la estructura DOT11_AUTH_CIPHER_PAIR_LIST. El controlador de minipuerto también debe copiar toda la estructura de DOT11_AUTH_CIPHER_PAIR_LIST en el miembro InformationBuffer .
- Devuelve NDIS_STATUS_SUCCESS de su función MiniportOidRequest .
Si WPS está habilitado en una NIC que funciona en modo AP extensible, el controlador de minipuerto debe permitir que las estaciones del mismo nivel se asocien a extensible AP mediante la autenticación abierta del sistema o algoritmos de privacidad equivalente cableada (WEP), independientemente de los algoritmos de autorización y cifrado habilitados. Para obtener más información sobre WPS y Extensible AP, vea OID_DOT11_WPS_ENABLED.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| Encabezado | windot11.h (incluye Ndis.h) |