DOT11EXT_SET_KEY_MAPPING_KEY Rückruffunktion (wlanihv.h)

Artikel
03/01/2024

Wichtig Die native WLAN-Schnittstelle 802.11 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 DLL für IHV-Erweiterungen ruft die Dot11ExtSetKeyMappingKey-Funktion auf, um einen Verschlüsselungsschlüssel aus den Schlüsselzuordnungsschlü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_KEY_MAPPING_KEY Dot11extSetKeyMappingKey;

DWORD Dot11extSetKeyMappingKey(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           PDOT11_CIPHER_KEY_MAPPING_KEY_VALUE pKey
)
{...}

Parameter

[in, optional] hDot11SvcHandle

Das Handle, das vom Betriebssystem verwendet wird, um auf den WLAN-Adapter zu verweisen. Dieser Handlewert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

[in] pKey

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

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 Schlüsselzuordnungsschlüssel wird aus den Schlüsseltabellen des Adapters gelöscht, wenn das bDelete-Element der DOT11_CIPHER_KEY_MAPPING_KEY_VALUE Struktur ist auf TRUE festgelegt.

Ein Aufruf der Dot11ExtSetKeyMappingKey-Funktion führt zu einer set-Anforderung des OID_DOT11_CIPHER_KEY_MAPPING_KEY Objektbezeichner (OID) an den nativen 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 (wlanihv.h einschließen)

Weitere Informationen

OID_DOT11_CIPHER_KEY_MAPPING_KEY

802.11 Verschlüsselungsschlüsseltypen

DOT11_CIPHER_KEY_MAPPING_KEY_VALUE

Dot11ExtIhvInitAdapter

Freigeben über