DOT11EXT_SET_AUTH_ALGORITHM Rückruffunktion (wlanihv.h)

Artikel
03/05/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 Dot11ExtSetAuthAlgorithm-Funktion auf, um einen Authentifizierungsalgorithmus für den WLAN-Adapter (WLAN) zu aktivieren.

Syntax

DOT11EXT_SET_AUTH_ALGORITHM Dot11extSetAuthAlgorithm;

DWORD Dot11extSetAuthAlgorithm(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           DWORD dwAuthAlgo
)
{...}

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

Ein DOT11_AUTH_ALGORITHM Enumeratorwert, der den Authentifizierungsalgorithmus identifiziert.

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

Andernfalls ist die DLL für die Verarbeitung eines Standardauthentifizierungsalgorithmus verantwortlich, der vom Betriebssystem unterstützt wird. In diesem Fall ist das Betriebssystem nicht an der Authentifizierungsverarbeitung über eine BSS-Netzwerkverbindung (Basic Service Set) über den WLAN-Adapter beteiligt.

Hinweis Der Wert von dwAuthAlgo muss mit dem Wert eines Authentifizierungsalgorithmus übereinstimmen, der vom nativen 802.11-Miniporttreiber zurückgegeben wird, indem die entsprechenden xxxAlgoPairs-Member der DOT11_EXTSTA_ATTRIBUTES-Struktur festgelegt werden. Dies muss mit den Werten übereinstimmen, 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_MULTICAST_ALGORITHM_PAIR

DOT11_AUTH_ALGORITHM

Dot11ExtIhvInitAdapter

Dot11ExtPreAssociateCompletion OID_DOT11_SUPPORTED_UNICAST_ALGORITHM_PAIR

Freigeben über