DOT11_AUTH_CIPHER_PAIR_LIST-Struktur (windot11.h)
Syntax
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;
Member
Header
Der Typ, die Revision und die Größe der DOT11_AUTH_CIPHER_PAIR_LIST-Struktur. Dieses Element ist als NDIS_OBJECT_HEADER-Struktur formatiert.
Der Miniporttreiber muss die Member von Header auf die folgenden Werte festlegen:
Typ
Dieser Member muss auf NDIS_OBJECT_TYPE_DEFAULT festgelegt werden.
Revision
Dieser Member muss auf DOT11_AUTH_CIPHER_PAIR_LIST_REVISION_1 festgelegt werden.
Size
Dieses Element muss auf sizeof(DOT11_AUTH_CIPHER_PAIR_LIST)festgelegt werden.
Weitere Informationen zu diesen Membern finden Sie unter NDIS_OBJECT_HEADER.
uNumOfEntries
Die Anzahl der Einträge im AuthCipherPairs-Array .
uTotalNumOfEntries
Die maximale Anzahl von Einträgen, die das AuthCipherPairs-Array enthalten kann.
AuthCipherPairs[1]
Die Liste der DOT11_AUTH_CIPHER_PAIR Strukturen.
Hinweise
Ein Miniporttreiber gibt die DOT11_AUTH_CIPHER_PAIR_LIST-Struktur zurück, wenn er von einem der Beiden abgefragt wird. OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR oder OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR.
Wenn diese OIDs abgefragt werden, muss der Miniporttreiber überprüfen, ob der InformationBuffer-Member des OidRequest-Parameters der MiniportOidRequest-Funktion groß genug ist, um die gesamte DOT11_AUTH_CIPHER_PAIR_LIST-Struktur zurückzugeben, einschließlich aller Einträge im AuthCipherPairs-Array. Der Wert des InformationBufferLength-Members des OidRequest-Parameters bestimmt, was der Miniporttreiber tun muss, wie die folgende Liste zeigt:
-
Wenn der Wert des InformationBufferLength-Members kleiner als die Länge (in Bytes) der gesamten DOT11_AUTH_CIPHER_PAIR_LIST-Struktur ist, muss der Miniporttreiber folgendes tun:
- Legen Sie für den OidRequest-Parameter das BytesWritten-Element auf Null und das BytesNeed-Element auf die Länge der gesamten DOT11_AUTH_CIPHER_PAIR_LIST-Struktur in Bytes fest.
- Führen Sie einen Fehler für die Abfrageanforderung durch Zurückgeben NDIS_STATUS_BUFFER_OVERFLOW aus der MiniportOidRequest-Funktion aus.
-
Wenn der Wert des InformationBufferLength-Members größer oder gleich der Länge (in Bytes) der gesamten DOT11_AUTH_CIPHER_PAIR_LIST-Struktur ist, muss der Miniporttreiber die folgenden Schritte ausführen, um eine erfolgreiche Abfrageanforderung abzuschließen:
- Legen Sie für die DOT11_AUTH_CIPHER_PAIR_LIST-Struktur die Elemente uNumOfEntries und uTotalNumOfEntries auf die Gesamtzahl der Einträge im AuthCipherPairs-Array fest.
- Legen Sie für den OidRequest-Parameter den BytesNeed-Member auf Null und den BytesWritten-Member auf die Länge der gesamten DOT11_AUTH_CIPHER_PAIR_LIST-Struktur in Bytes fest. Der Miniporttreiber muss auch die gesamte DOT11_AUTH_CIPHER_PAIR_LIST-Struktur in das InformationBuffer-Element kopieren.
- Gibt NDIS_STATUS_SUCCESS aus der MiniportOidRequest-Funktion zurück.
Wenn WPS für eine NIC aktiviert ist, die im Extensible AP-Modus ausgeführt wird, muss der Miniporttreiber zulassen, dass Peerstationen der Extensible AP mithilfe von WeP-Algorithmen ( Open System Authentication ) oder WeP (Wired Equivalent Privacy) zugeordnet werden können, unabhängig von den aktivierten Autorisierungs- und Verschlüsselungsalgorithmen. Weitere Informationen zu WPS und Extensible AP finden Sie unter OID_DOT11_WPS_ENABLED.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Kopfzeile | windot11.h (include Ndis.h) |