DOT11EXT_SET_DEFAULT_KEY_ID Rückruffunktion (wlanihv.h)

Artikel
02/07/2025

Wichtige 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 driver model.

Die IHV Extensions DLL ruft die Dot11ExtSetDefaultKeyId Funktion auf, um den Tabellenindex des Standardschlüssels oder der Verschlüsselung pro Station festzulegen, mit dem der WLAN-Adapter (Wireless LAN) standardmäßig verwendet wird, wenn übertragene Paketdaten verschlüsselt werden.

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 Handlewert wurde über einen vorherigen Aufruf der Dot11ExtIhvInitAdapter IHV-Handlerfunktion angegeben.

[in] uDefaultKeyId

Der Indexwert des Schlüssels innerhalb der Standard- oder Pro-Station-Verschlüsselungstabellen des Adapters.

Für Standardmäßige 802.11-Verschlüsselungsalgorithmen, z. B. WEP oder TKIP, muss uDefaultKeyId zwischen 0 und 3 sein. Für einen proprietären Chiffrealgorithmus, der von einem IHV entwickelt wurde, kann uDefaultKeyId beliebige Werte innerhalb des bereichs sein, der von der IHV definiert wird.

Rückgabewert

Wenn der Aufruf erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück. Andernfalls wird ein fehlercode zurückgegeben, der in Winerror.h definiert ist.

Bemerkungen

Der Standardschlüsselbezeichner (ID) gibt den Index eines Chiffreschlüssels in den Standardschlüsseltabellen des Adapters und standardschlüsseltabellen pro Station an, die der Adapter für die Datenverschlüsselung verwendet. Der Adapter verwendet den Verschlüsselungsschlüssel, auf den die Standardschlüssel-ID als Standardverschlüsselungsschlüssel für übertragene Pakete verweist, es sei denn, ein Schlüsselzuordnungsschlüssel ist für die Zielmedienzugriffssteuerungsadresse (MAC) 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 Satzanforderung der OID_DOT11_CIPHER_DEFAULT_KEY_ID Objektbezeichner (OID) zum Native 802.11 Miniporttreiber, der den WLAN-Adapter verwaltet.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform-	Desktop
Header-	wlanihv.h (inklusive Wlanihv.h)

Siehe auch

OID_DOT11_CIPHER_DEFAULT_KEY_ID

Dot11ExtIhvInitAdapter

802.11 Verschlüsselungsschlüsseltypen

Freigeben über