DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM Rückruffunktion (wlanihv.h)

Artikel
02/27/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 Dot11ExtSetUnicastCipherAlgorithm-Funktion auf, um einen Unicast-Verschlüsselungsalgorithmus auf dem WLAN-Adapter (WLAN) zu aktivieren.

Syntax

DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM Dot11extSetUnicastCipherAlgorithm;

DWORD Dot11extSetUnicastCipherAlgorithm(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwUnicastCipherAlgo
)
{...}

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

Ein DOT11_CIPHER_ALGORITHM Enumeratorwert, der den Unicastverschlüsselungsalgorithmus identifiziert.

Wenn der Wert innerhalb des Bereichs von DOT11_CIPHER_ALGO_IHV_START bis DOT11_CIPHER_ALGO_IHV_END liegt, aktiviert die DLL für IHV-Erweiterungen einen proprietären Verschlüsselungsalgorithmus, der vom WLAN-Adapter unterstützt wird.

Andernfalls ist die DLL für die Verarbeitung eines vom Betriebssystem unterstützten Verschlüsselungsalgorithmus verantwortlich. In dieser Situation ist das Betriebssystem nicht an einem Aspekt des Verschlüsselungsalgorithmus beteiligt, einschließlich Schlüsselverwaltung und Wiedergabeschutz, über eine BSS-Netzwerkverbindung (Basic Service Set) über den WLAN-Adapter.

Hinweis Der Wert von dwUnicastCipherAlgo muss mit dem Wert eines Verschlüsselungsalgorithmus übereinstimmen, der vom nativen 802.11-Miniporttreiber zurückgegeben wird, indem die entsprechenden xxxAlgoPairs-Member der DOT11_EXTSTA_ATTRIBUTES-Struktur festgelegt werden, die mit den Werten übereinstimmen müssen, die von Abfragen von OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR oder OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR zurückgegeben würden.

Rückgabewert

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

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_SUPPORTED_UNICAST_ALGORITHM_PAIR OID_DOT11_SUPPORTED_MULTICAST_ALGORITHM_PAIR

DOT11_CIPHER_ALGORITHM

Dot11ExtIhvInitAdapter

Freigeben über