DOT11EXT_SET_UNICAST_CIPHER_ALGORITHM 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 Dot11ExtSetUnicastCipherAlgorithm Funktion auf, um einen Unicast-Verschlüsselungsalgorithmus auf dem WLAN-Adapter (Wireless LAN) zu ermöglichen.

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

[in] dwUnicastCipherAlgo

Ein DOT11_CIPHER_ALGORITHM Enumerationswert, der den Unicast-Verschlüsselungsalgorithmus identifiziert.

Wenn sich der Wert im Bereich von DOT11_CIPHER_ALGO_IHV_START über DOT11_CIPHER_ALGO_IHV_END befindet, ermöglicht die IHV Extensions DLL 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 Standardchiffrealgorithmus verantwortlich. In diesem Fall ist das Betriebssystem nicht an einem Aspekt des Verschlüsselungsalgorithmus beteiligt, einschließlich Schlüsselverwaltung und Replay-Schutz, über eine grundlegende BSS-Netzwerkverbindung über den WLAN-Adapter.

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

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.

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

DOT11_CIPHER_ALGORITHM

Dot11ExtIhvInitAdapter

Freigeben über