DOT11EXT_SET_VIRTUAL_STATION_AP_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 Dot11ExtSetVirtualStationAPProperties Funktion auf, um die aktuelle IHV-Profilverbindung anzugeben.

Syntax

DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES Dot11extSetVirtualStationApProperties;

DWORD Dot11extSetVirtualStationApProperties(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwNumProperties,
  [in]           PDOT11EXT_VIRTUAL_STATION_AP_PROPERTY pProperties,
                 LPVOID pvReserved
)
{...}

Parameter

[in, optional] hDot11SvcHandle

Ein optionaler Handle, der 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.

[in, optional] hConnectSession

Das Handle, das vom Betriebssystem verwendet wird, um auf die aktuelle Verbindungssitzung mit dem BSS-Netzwerk (Basic Service Set) zu verweisen. Dieser Handlewert wurde als hConnectSession Parameter über einen vorherigen Aufruf des Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion.

[in] dwNumProperties

Die Anzahl der Elemente im Array von Strukturen, auf die durch den pProperties Parameter verwiesen wird.

[in] pProperties

Ein Zeiger auf ein Array von DOT11EXT_VIRTUAL_STATION_AP_PROPERTY Strukturen, die die Eigenschaften von Zugriffspunkten (APs) angeben, die die virtuelle 802.11-Station versucht, in der aktuellen Verbindungssitzung zu hosten.

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

Wenn es sich bei der aktuellen IHV-Profilverbindung um einen Zugriffspunkt (ACCESS Point, AP) handelt und die IHV-Erweiterungs-DLL dem Betriebssystem die von der AP verwendeten Einstellungen bereitstellen kann, kann das Betriebssystem zusätzliche Informationen für Benutzer bereitstellen, die AP-bezogene Dienste vom Betriebssystem anfordern.

Wenn die IHV Extensions DLL Dot11ExtSetVirtualStationAPPropertiesaufruft, muss dies vor dem Aufrufen der Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion. Wenn Dot11ExtSetVirtualStationAPProperties nicht vor erfolgreichem Abschluss des Vorzuordnungsvorgangs aufgerufen wird, nimmt das Betriebssystem keine Annahmen über die Art des IHV-Profils vor.

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

Dot11ExtIhvPerformPreAssociate

Dot11ExtIhvInitAdapter

DOT11EXT_VIRTUAL_STATION_AP_PROPERTY

Freigeben über