DOT11EXT_SET_PROFILE_CUSTOM_USER_DATA Rückruffunktion (wlanihv.h)

Artikel
03/01/2024

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 Dot11ExtSetProfileCustomUserData-Funktion auf, um Daten in der Systemregistrierung zu speichern, die für das aktuelle Benutzer- und Netzwerkprofil spezifisch ist, das für die BSS-Netzwerkverbindung (Basic Service Set) 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 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 zu verweisen. Dieser Handle-Wert wurde durch einen vorherigen Aufruf von angegeben. Dot11ExtIhvPerformPreAssociate IHV-Handlerfunktion.

[in] dwSessionID

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

[in] dwDataSize

Die Größe des Puffers in Bytes, auf den von pvData verwiesen wird.

[in] pvData

Ein Zeiger auf einen vom Aufrufer zugeordneten Puffer, der die Daten in einem vom IHV definierten Format enthält.

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

Das Betriebssystem verschlüsselt die Daten, auf die vom pvData-Parameter verwiesen wird, nicht, bevor sie in der Systemregistrierung gespeichert werden. Die DLL für IHV-Erweiterungen sollte einen eigenen Verschlüsselungsalgorithmus verwenden, um die Daten vor dem Aufruf von Dot11ExtSetProfileCustomUserData zu verschlüsseln.

Für jedes wlan-Profil, das vom Native Wifi AutoConfig-Dienst verwendet wird, behält Windows das Konzept der benutzerdefinierten Benutzerdaten bei. Diese benutzerdefinierten Benutzerdaten sind zunächst nicht vorhanden, können aber durch Aufrufen der Dot11ExtSetProfileCustomUserData-Funktion festgelegt werden. Die benutzerdefinierten Benutzerdaten werden jedes Mal auf leer zurückgesetzt, wenn das Profil durch Aufrufen von Dot11ExtSetCurrentProfile-Funktion .

Nachdem benutzerdefinierte Benutzerdaten festgelegt wurden, kann 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
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

Dot11ExtSetCurrentProfile

Dot11ExtIhvPerformPreAssociate Dot11ExtGetProfileCustomUserData

Freigeben über