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 |