DOT11EXT_QUERY_VIRTUAL_STATION_PROPERTIES 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 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 (WLAN) zu verweisen. Dieser Handlewert wurde als hDot11SvcHandle Parameter über einen vorherigen Aufruf der Dot11ExtIhvInitAdapter IHV-Handlerfunktion empfangen.

[out] pbIsVirtualStation

Ein Zeiger auf einen booleschen Wert, der angibt, ob der primäre physische WLAN-Adapter, auf den der hDot11SvcHandle Parameter verweist, ein virtueller Stationsadapter ist oder nicht. Wenn der Wert TRUEist, handelt es sich beim abgefragten Adapter um 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 hosten soll. Dieser Parameter ist nur gültig, wenn pbIsVirtualStation auf einen Wert verweist, der TRUEist.

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.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar in Windows 7 und höheren Versionen von Windows-Betriebssystemen.
Zielplattform-	Desktop
Header-	wlanihv.h (inklusive Wlanihv.h)

Siehe auch

Dot11ExtIhvInitAdapter

Freigeben über