DOT11EXT_SET_DEFAULT_KEY_ID Rückruffunktion (wlanihv.h)

Wichtig Die Native 802.11 Wireless LAN-Schnittstelle ist in Windows 10 und höher veraltet. Verwenden Sie stattdessen die WLAN Device Driver Interface (WDI). Weitere Informationen zu WDI finden Sie unter Wlan Universal Windows-Treibermodell.

 

Die IHV-Erweiterungen-DLL ruft die Dot11ExtSetDefaultKeyId-Funktion auf, um den Tabellenindex des Standardschlüssels oder der Verschlüsselung pro Station festzulegen, mit dem der WLAN-Adapter standardmäßig beim Verschlüsseln übertragener Paketdaten verwendet.

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)

Weitere Informationen

OID_DOT11_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter

802.11 Verschlüsselungsschlüsseltypen