DOT11EXT_RELEASE_VIRTUAL_STATION 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 Dot11ExtReleaseVirtualStation Funktion auf, um eine frühere Version freizugeben. Dot11ExtRequestVirtualStation Anforderung zum Erstellen einer virtuellen 802.11-Station.

Syntax

DOT11EXT_RELEASE_VIRTUAL_STATION Dot11extReleaseVirtualStation;

DWORD Dot11extReleaseVirtualStation(
  [in, optional] HANDLE hDot11PrimaryHandle,
                 LPVOID pvReserved
)
{...}

Parameter

[in, optional] hDot11PrimaryHandle

Das Handle, das vom Betriebssystem verwendet wird, um auf den primären physischen WLAN-Adapter (WLAN) zu verweisen. Dieser Handlewert wurde als hDot11SvcHandle Parameter über einen vorherigen Aufruf der Dot11ExtIhvInitAdapter IHV-Handlerfunktion empfangen. Es ist auch der hDot11PrimaryHandle Parameter, den die IHV Extension DLL in einem vorherigen Aufruf verwendet hat Dot11ExtRequestVirtualStation.

pvReserved

Dieser Parameter ist für die Verwendung durch das Betriebssystem reserviert und sollte NULL-sein.

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.

Bemerkungen

Das Betriebssystem kann einen Aufruf der Dot11ExtReleaseVirtualStation Funktion ignorieren, wenn die virtuelle 802.11-Station noch benötigt wird oder wenn das Betriebssystem bereits eine Anforderung zum Entfernen der virtuellen Station verarbeitet.

Wenn diese Releasefunktion erfolgreich abgeschlossen ist, wurde die virtuelle Station gelöscht, oder das Betriebssystem befindet sich beim Löschen der virtuellen Station.

Ein Aufruf von Dot11ExtReleaseVirtualStation informiert das Betriebssystem, dass die virtuelle Station nicht mehr von der IHV Extensions DLL angefordert wird. Die IHV Extensions DLL sollte jedoch keine Daten aufheben, die für die virtuelle Station spezifisch sind, bis sie einen Aufruf der Dot11ExtIhvDeinitAdapter IHV-Handlerfunktion empfängt.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 7
Zielplattform-	Desktop
Header-	wlanihv.h (inklusive Wlanihv.h)

Siehe auch

Dot11ExtRequestVirtualStation

Dot11ExtIhvInitAdapter

Freigeben über