Freigeben über


DOT11EXT_SET_CURRENT_PROFILE Rückruffunktion (wlanihv.h)

Wichtig Die native WLAN-Schnittstelle 802.11 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 DLL für IHV-Erweiterungen ruft die Dot11ExtSetCurrentProfile-Funktion auf, um die Einstellungen für die von IHV definierten Konnektivitäts- und Sicherheitsprofilfragmente anzugeben. Diese Fragmente werden auf das aktuelle Netzwerkprofil angewendet.

Syntax

DOT11EXT_SET_CURRENT_PROFILE Dot11extSetCurrentProfile;

DWORD Dot11extSetCurrentProfile(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in, optional] PDOT11EXT_IHV_CONNECTIVITY_PROFILE pIhvConnProfile,
  [in, optional] PDOT11EXT_IHV_SECURITY_PROFILE pIhvSecProfile
)
{...}

Parameter

[in, optional] hDot11SvcHandle

Das Handle, das vom Betriebssystem verwendet wird, um auf den WLAN-Adapter (Wireless LAN) zu verweisen. Dieser Handlewert wurde durch einen vorherigen Aufruf der IHV-Handlerfunktion Dot11ExtIhvInitAdapter angegeben.

[in, optional] hConnectSession

Das Handle, das vom Betriebssystem verwendet wird, um auf die Verbindungssitzung mit dem BSS-Netzwerk (Basic Service Set) zu verweisen. Dieser Handle-Wert wurde durch einen vorherigen Aufruf von angegeben. Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion.

[in, optional] pIhvConnProfile

Ein Zeiger auf eine DOT11EXT_IHV_CONNECTIVITY_PROFILE Struktur, die Konnektivitätseinstellungen für das IHV-Profil enthält.

[in, optional] pIhvSecProfile

Ein Zeiger auf eine DOT11EXT_IHV_SECURITY_PROFILE Struktur, die Sicherheitseinstellungen für das IHV-Profil angibt.

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

Die Dot11ExtSetCurrentProfile-Funktion ermöglicht es dem IHV, dem aktuellen Netzwerkprofil, das für die BSS-Netzwerkverbindung (Basic Service Set) verwendet wird, benutzerdefinierte Konnektivitäts- und Sicherheitsprofilfragmente hinzuzufügen. Die Profilfragmente sind IHV-spezifisch und gelten für Konnektivitäts- oder Sicherheitserweiterungen, die dem Benutzer über die NATIVE 802.11-DLL für IHV-UI-Erweiterungen zur Verfügung stehen.

Die DLL für IHV-Erweiterungen muss beim Aufrufen der Dot11ExtSetCurrentProfile-Funktion die folgenden Richtlinien befolgen:

  • Die DLL für IHV-Erweiterungen darf nur Dot11ExtSetCurrentProfile aufrufen, wenn sie einen Vorabzuordnungsvorgang ausführt, der über einen Aufruf von initiiert wird. Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion. Weitere Informationen zum Vorgang vor der Zuordnung finden Sie unter Pre-Association Operation.
  • Die DLL für IHV-Erweiterungen darf Dot11ExtSetCurrentProfile nicht innerhalb des Aufrufs von aufrufen. Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion. Dot11ExtSetCurrentProfile muss von einem anderen Thread als dem aufgerufen werden, der den Aufruf von Dot11ExtIhvPerformPreAssociate verarbeitet.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Versionen der Windows-Betriebssysteme.
Zielplattform Desktop
Kopfzeile wlanihv.h (wlanihv.h einschließen)

Weitere Informationen

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Dot11ExtIhvPerformPreAssociate DOT11EXT_IHV_CONNECTIVITY_PROFILE