DOT11EXT_SET_DEFAULT_KEY_ID Rückruffunktion (wlanihv.h)
Syntax
DOT11EXT_SET_DEFAULT_KEY_ID Dot11extSetDefaultKeyId;
DWORD Dot11extSetDefaultKeyId(
[in, optional] HANDLE hDot11SvcHandle,
[in] ULONG uDefaultKeyId
)
{...}
Parameter
[in, optional] hDot11SvcHandle
Das Handle, das vom Betriebssystem verwendet wird, um auf den WLAN-Adapter zu verweisen. Dieser Handle-Wert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.
[in] uDefaultKeyId
Der Indexwert des Schlüssels in den Standard- oder Stationsschlüsseltabellen des Adapters.
Für standard 802.11-Verschlüsselungsalgorithmen wie WEP oder TKIP muss uDefaultKeyId zwischen 0 und 3 sein. Für einen proprietären Verschlüsselungsalgorithmus, der von einem IHV entwickelt wurde, kann uDefaultKeyId ein beliebiger Wert innerhalb des vom IHV definierten Bereichs sein.
Rückgabewert
Wenn der Aufruf erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein in Winerror.h definierter Fehlercode zurückgegeben.
Hinweise
Die Standardschlüssel-ID gibt den Index eines Verschlüsselungsschlüssels in den Standardschlüsseltabellen des Adapters und der Standardschlüsseltabellen pro Station an, die der Adapter für die Datenverschlüsselung verwendet. Der Adapter verwendet den Verschlüsselungsschlüssel, auf den von der Standardschlüssel-ID verwiesen wird, als Standardverschlüsselungsschlüssel für übertragene Pakete, es sei denn, für die MAC-Adresse (Zielmedienzugriffssteuerung) ist ein Schlüsselzuordnungsschlüssel vorhanden. Weitere Informationen zu diesen Verschlüsselungsschlüsseltypen finden Sie unter 802.11 Verschlüsselungsschlüsseltypen.
Ein Aufruf der Dot11ExtSetDefaultKeyId-Funktion führt zu einer festgelegten Anforderung des OID_DOT11_CIPHER_DEFAULT_KEY_ID Objektbezeichner (OID) an den Native 802.11-Miniporttreiber, der den WLAN-Adapter verwaltet.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme. |
| Zielplattform | Desktop |
| Kopfzeile | wlanihv.h (include Wlanihv.h) |