DOT11EXT_SET_EXCLUDE_UNENCRYPTED 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 Dot11ExtSetExcludeUnencrypted-Funktion auf, um den WLAN-Adapter (WLAN) zu aktivieren oder zu deaktivieren, nicht verschlüsselte Pakete auszuschließen, die er empfängt, während er für Verschlüsselungsvorgänge aktiviert ist.

Syntax

DOT11EXT_SET_EXCLUDE_UNENCRYPTED Dot11extSetExcludeUnencrypted;

DWORD Dot11extSetExcludeUnencrypted(
  [in, optional] HANDLE hDot11SvcHandle,
  [in]           BOOL bExcludeUnencrypted
)
{...}

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

Ein boolescher Wert, der bei Festlegung auf TRUE den WLAN-Adapter so konfiguriert, dass unverschlüsselte Pakete ausgeschlossen werden.

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

Wenn der WLAN-Adapter zum Ausschließen unverschlüsselter Pakete aktiviert ist, muss die Station empfangene Pakete ausschließen, die einem Eintrag in der aktuellen EtherType-Ausnahmeliste der Station entsprechen. Die DLL für IHV-Erweiterungen gibt die EtherType-Ausnahmeliste durch Aufrufe an. Dot11ExtSetEtherTypeHandling-Funktion .

Ein Aufruf der Funktion Dot11ExtSetExcludeUnencrypted führt zu einer Setanforderung des OID_DOT11_EXCLUDE_UNENCRYPTED Objektbezeichner (OID) an den Native 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 (include Wlanihv.h)

Weitere Informationen

OID_DOT11_EXCLUDE_UNENCRYPTED

Dot11ExtSetEtherTypeHandling

Dot11ExtIhvInitAdapter

Freigeben über