DOT11EXT_SET_DEFAULT_KEY Rückruffunktion (wlanihv.h)

Artikel
03/01/2024

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 Dot11ExtSetDefaultKey-Funktion auf, um einen Verschlüsselungsschlüssel aus den Standardschlüsseltabellen oder stationsspezifischen Standardschlüsseltabellen des WLAN-Adapters (WLAN) hinzuzufügen oder zu löschen. Weitere Informationen zu diesen Schlüsseltypen finden Sie unter 802.11 Verschlüsselungsschlü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 Handle-Wert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

[in] pKey

Ein Zeiger auf eine DOT11_CIPHER_DEFAULT_KEY_VALUE Struktur, die den Verschlüsselungsschlüssel definiert.

[in] dot11Direction

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

Hinweis Die DLL für IHV-Erweiterungen 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 in Winerror.h definierter Fehlercode zurückgegeben.

Hinweise

Ein Aufruf der Dot11ExtSetDefaultKey-Funktion führt zu einer festgelegten Anforderung des OID_DOT11_CIPHER_DEFAULT_KEY Objektbezeichner auf den WLAN-Adapter.

Ein Standardchiffreschlüssel wird durch Festlegen des MacAddr-Elements des DOT11_CIPHER_DEFAULT_KEY_VALUE Struktur auf den Wert 0x000000000000. Ein stationsspezifischer Standardchiffreschlüssel wird definiert, indem sie das MacAddr-Element auf eine gültige MAC-Adresse (Unicast Media Access Control) festlegen.

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

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)