DOT11EXT_SET_DEFAULT_KEY Rückruffunktion (wlanihv.h)

2025-02-07

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 Dot11ExtSetDefaultKey--Funktion auf, um einen Chiffreschlüssel aus den Standardschlüsseltabellen oder standardschlüsseltabellen des WLAN-Adapters (Wireless LAN) hinzuzufügen oder zu löschen. Weitere Informationen zu diesen Schlüsseltypen finden Sie unter 802.11 Chiffreschlüsseltypen.

Syntax

DOT11EXT_SET_DEFAULT_KEY Dot11extSetDefaultKey;

DWORD Dot11extSetDefaultKey(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           PDOT11_CIPHER_DEFAULT_KEY_VALUE pKey,
  [in]           DOT11_DIRECTION dot11Direction
)
{...}

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] pKey

Ein Zeiger auf ein DOT11_CIPHER_DEFAULT_KEY_VALUE Struktur, die den Chiffreschlüssel definiert.

[in] dot11Direction

Ein DOT11_DIRECTION Wert, der angibt, ob der Schlüssel nur für empfangene Pakete (DOT11_DIR_INBOUND) oder sowohl empfangene als auch gesendete Pakete (DOT11_DIR_BOTH) verwendet werden kann.

Hinweis Die IHV Extensions DLL darf keinen Wert von DOT11_DIR_OUTBOUND an diesen Parameter übergeben.

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

Ein Aufruf der Dot11ExtSetDefaultKey-Funktion führt zu einer Satzanforderung der OID_DOT11_CIPHER_DEFAULT_KEY Objektbezeichner an den WLAN-Adapter.

Ein Standardchiffreschlüssel wird durch Festlegen des MacAddr- Mitglieds des DOT11_CIPHER_DEFAULT_KEY_VALUE Struktur zu einem Wert von 0x000000000000. Ein Standardchiffreschlüssel pro Station wird definiert, indem der MacAddr Member auf eine gültige Mac-Adresse (Unicast Media Access Control) festgelegt wird.

Ein Chiffreschlüssel wird aus den Schlüsseltabellen des Adapters gelöscht, wenn das bDelete Mitglied des Adapters DOT11_CIPHER_DEFAULT_KEY_VALUE Struktur wird auf TRUE-festgelegt.

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)