DOT11EXT_SET_CURRENT_PROFILE 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 Dot11ExtSetCurrentProfile Funktion auf, um die Einstellungen für die 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 über einen vorherigen Aufruf der Dot11ExtIhvInitAdapter IHV-Handlerfunktion 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 Handlewert wurde über einen vorherigen Aufruf des Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion.

[in, optional] pIhvConnProfile

Ein Zeiger auf ein DOT11EXT_IHV_CONNECTIVITY_PROFILE Struktur, die Verbindungseinstellungen für das IHV-Profil enthält.

[in, optional] pIhvSecProfile

Ein Zeiger auf ein 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 fehlercode zurückgegeben, der in Winerror.h definiert ist.

Bemerkungen

Mit der Dot11ExtSetCurrentProfile--Funktion kann der IHV benutzerdefinierte Verbindungs- und Sicherheitsprofilfragmente zum aktuellen Netzwerkprofil hinzufügen, das für die Grundlegende Dienstsatz-Netzwerkverbindung (BSS) verwendet wird. Die Profilfragmente sind IHV-spezifisch und gelten für Konnektivitäts- oder Sicherheitserweiterungen, die dem Benutzer über die Native 802.11 IHV UI Extensions DLLzur Verfügung stehen.

Die IHV Extensions DLL muss beim Aufrufen der Dot11ExtSetCurrentProfile Funktion die folgenden Richtlinien befolgen:

Die IHV-Erweiterungs-DLL darf nur Dot11ExtSetCurrentProfile- aufrufen, wenn ein vorzuordnungsvorgang ausgeführt wird, der über einen Aufruf des Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion. Weitere Informationen zum Vorzuordnungsvorgang finden Sie unter Pre-Association Operation.
Die IHV Extensions DLL darf Dot11ExtSetCurrentProfile- nicht innerhalb des Aufrufs des Aufrufs aufrufen. Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion. Dot11ExtSetCurrentProfile- muss von einem anderen Thread aufgerufen werden als der, der den Aufruf an Dot11ExtIhvPerformPreAssociateverarbeitet.

Anforderungen

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

Siehe auch

Dot11ExtIhvInitAdapter

DOT11EXT_IHV_SECURITY_PROFILE

Dot11ExtIhvPerformPreAssociate DOT11EXT_IHV_CONNECTIVITY_PROFILE

Freigeben über