Freigeben über


UnloadUserProfile-Funktion (userenv.h)

Entlädt das Profil eines Benutzers, das von der LoadUserProfile-Funktion geladen wurde. Der Aufrufer muss über Administratorrechte auf dem Computer verfügen. Weitere Informationen finden Sie im Abschnitt Hinweise der LoadUserProfile-Funktion .

Syntax

USERENVAPI BOOL UnloadUserProfile(
  [in] HANDLE hToken,
  [in] HANDLE hProfile
);

Parameter

[in] hToken

Typ: HANDLE

Token für den Benutzer, das von der Funktion LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken oder OpenThreadToken zurückgegeben wird. Das Token muss über TOKEN_IMPERSONATE und TOKEN_DUPLICATE Zugriff verfügen. Weitere Informationen finden Sie unter Zugriffsrechte für Access-Token-Objekte.

[in] hProfile

Typ: HANDLE

Handle mit dem Registrierungsschlüssel. Dieser Wert ist das hProfile-Element der PROFILEINFO-Struktur . Weitere Informationen finden Sie im Abschnitt Hinweise unter LoadUserProfile und RegistrierungsschlüsselSicherheit und Zugriffsrechte.

Rückgabewert

Typ: BOOL

TRUE , wenn erfolgreich; andernfalls FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Vor dem Aufrufen von UnloadUserProfile sollten Sie sicherstellen, dass alle Handles für Schlüssel, die Sie in der Registrierungsstruktur des Benutzers geöffnet haben, geschlossen sind. Wenn Sie nicht alle geöffneten Registrierungshandles schließen, kann das Profil des Benutzers nicht entladen werden. Weitere Informationen finden Sie unter Sicherheit und Zugriffsrechte für Registrierungsschlüssel und Registrierungsstruktur.

Weitere Informationen zum Aufrufen von Funktionen, die Administratorrechte erfordern, finden Sie unter Ausführen mit speziellen Berechtigungen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile userenv.h
Bibliothek Userenv.lib
DLL Userenv.dll

Weitere Informationen

LoadUserProfile

PROFILEINFO

Übersicht über Benutzerprofile

Referenz zu Benutzerprofilen