DOT11EXT_SET_VIRTUAL_STATION_AP_PROPERTIES Rückruffunktion (wlanihv.h)

Die DLL für IHV-Erweiterungen 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 optionales Handle, das vom Betriebssystem verwendet wird, um auf den primären physischen WLAN-Adapter (Wireless LAN) zu verweisen. Dieser Handlewert wurde als hDot11SvcHandle-Parameter durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter 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 Handle-Wert wurde als hConnectSession-Parameter über einen vorherigen Aufruf von empfangen. Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion.

[in] dwNumProperties

Die Anzahl der Elemente im Array von Strukturen, auf die der pProperties-Parameter verweist.

[in] pProperties

Ein Zeiger auf ein Array von DOT11EXT_VIRTUAL_STATION_AP_PROPERTY Strukturen, die die Eigenschaften von Zugriffspunkten (Access Points, APs) angeben, die die virtuelle 802.11-Station in der aktuellen Verbindungssitzung hosten möchte.

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.

Hinweise

Wenn die aktuelle IHV-Profilverbindung ein Zugriffspunkt (AP) ist und die IHV-Erweiterungen-DLL dem Betriebssystem die vom AP verwendeten Einstellungen bereitstellen kann, kann das Betriebssystem zusätzliche Informationen für Benutzer bereitstellen, die ap-bezogene Dienste vom Betriebssystem anfordern.

Wenn die DLL für IHV-Erweiterungen Dot11ExtSetVirtualStationAPProperties aufruft, muss dies vor dem Aufruf von Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion. Wenn Dot11ExtSetVirtualStationAPProperties nicht vor erfolgreichem Abschluss des Vorzuordnungsvorgangs aufgerufen wird, trifft das Betriebssystem keine Annahmen über die Art des IHV-Profils.

Anforderungen

Weitere Informationen

Dot11ExtIhvInitAdapter