DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA 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 Dot11ExtSetProfileCustomUserData--Funktion auf, um Daten in der Systemregistrierung zu speichern, die spezifisch für den aktuellen Benutzer und das Netzwerkprofil sind, das für die grundlegende Dienstsatz-Netzwerkverbindung (BSS) verwendet wird.

Syntax

DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA Dot11extSetProfileCustomUserData;

DWORD Dot11extSetProfileCustomUserData(
  [in, optional] HANDLE hDot11SvcHandle,
  [in, optional] HANDLE hConnectSession,
  [in]           DWORD dwSessionID,
  [in]           DWORD dwDataSize,
  [in]           LPVOID pvData
)
{...}

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 zu verweisen. Dieser Handlewert wurde über einen vorherigen Aufruf des Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion.

[in] dwSessionID

Die Sitzungs-ID (Sitzungs-ID) des aktuellen Benutzers.

[in] dwDataSize

Die Größe des Puffers in Bytes, auf den pvData- verweist.

[in] pvData

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die Daten in einem format enthält, das vom IHV definiert ist.

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

Das Betriebssystem verschlüsselt die vom pvData Parameter referenzierten Daten nicht, bevor sie in der Systemregistrierung gespeichert werden. Die IHV Extensions DLL sollte einen eigenen Verschlüsselungsalgorithmus verwenden, um die Daten zu verschlüsseln, bevor sie Dot11ExtSetProfileCustomUserDataaufrufen.

Für jedes drahtlose WLAN-Profil, das vom Native Wifi AutoConfig-Dienst verwendet wird, verwaltet Windows das Konzept von benutzerdefinierten Benutzerdaten. Diese benutzerdefinierten Benutzerdaten sind anfänglich nicht vorhanden, können jedoch durch Aufrufen der Dot11ExtSetProfileCustomUserData-Funktion festgelegt werden. Die benutzerdefinierten Benutzerdaten werden bei jeder Änderung des Profils auf leer zurückgesetzt, indem das Profil aufgerufen wird. Dot11ExtSetCurrentProfile Funktion.

Nachdem benutzerdefinierte Benutzerdaten festgelegt wurden, können sie mithilfe der Dot11ExtGetProfileCustomUserData Funktion. Das Betriebssystem speichert die Daten unter der Systemregistrierung HKEY_CURRENT_USER Schlüssel für den Benutzer, auf den durch das handle verwiesen wird, das im dwSessionID Parameter übergeben wird.

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

Dot11ExtSetCurrentProfile-

Dot11ExtIhvPerformPreAssociate Dot11ExtGetProfileCustomUserData-

Freigeben über