DOT11EXT_QUERY_VIRTUAL_STATION_PROPERTIES 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 Dot11ExtQueryVirtualStationProperties-Funktion auf, um die Eigenschaften einer virtuellen 802.11-Station abzufragen.

Syntax

DOT11EXT_QUERY_VIRTUAL_STATION_PROPERTIES Dot11extQueryVirtualStationProperties;

DWORD Dot11extQueryVirtualStationProperties(
  [in, optional] HANDLE hDot11SvcHandle,
  [out]          BOOL *pbIsVirtualStation,
  [out]          GUID *pgPrimary,
                 LPVOID pvReserved
)
{...}

Parameter

[in, optional] hDot11SvcHandle

Ein Handle, das vom Betriebssystem verwendet wird, um auf den primären physischen WLAN-Adapter (WIRELESS LAN) zu verweisen. Dieser Handle-Wert wurde als hDot11SvcHandle-Parameter über einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter empfangen.

[out] pbIsVirtualStation

Ein Zeiger auf einen booleschen Wert, der angibt, ob der primäre physische WLAN-Adapter, auf den der Parameter hDot11SvcHandle verweist, ein adapter für virtuelle Station ist oder nicht. Wenn der Wert TRUE ist, ist der abgefragte Adapter eine virtuelle Station, andernfalls handelt es sich nicht um eine virtuelle Station.

[out] pgPrimary

Ein Zeiger auf einen GUID-Wert, der den primären physischen WLAN-Adapter identifiziert, der eine virtuelle Station hostet. Dieser Parameter ist nur gültig, wenn pbIsVirtualStation auf einen Wert zeigt, der TRUE ist.

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 in Winerror.h definierter Fehlercode zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 7 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Desktop
Kopfzeile	wlanihv.h (include Wlanihv.h)

Weitere Informationen

Dot11ExtIhvInitAdapter

Freigeben über