UnloadUserProfile, fonction (userenv.h)
Décharge le profil d’un utilisateur chargé par la fonction LoadUserProfile . L’appelant doit disposer de privilèges d’administration sur l’ordinateur. Pour plus d’informations, consultez la section Notes de la fonction LoadUserProfile .
Syntaxe
USERENVAPI BOOL UnloadUserProfile(
[in] HANDLE hToken,
[in] HANDLE hProfile
);
Paramètres
[in] hToken
Type : HANDLE
Jeton pour l’utilisateur, retourné par la fonction LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken ou OpenThreadToken . Le jeton doit avoir un accès TOKEN_IMPERSONATE et TOKEN_DUPLICATE . Pour plus d’informations, consultez Droits d’accès pour les objets Access-Token.
[in] hProfile
Type : HANDLE
Gérez la clé de Registre. Cette valeur est le membre hProfile de la structure PROFILEINFO . Pour plus d’informations, consultez la section Remarques de LoadUserProfile et des droits d’accès et de sécurité de la clé de Registre.
Valeur retournée
Type : BOOL
TRUE en cas de réussite ; sinon, FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
Avant d’appeler UnloadUserProfile , vous devez vous assurer que tous les handles des clés que vous avez ouverts dans la ruche du Registre de l’utilisateur sont fermés. Si vous ne fermez pas tous les handles de Registre ouverts, le profil de l’utilisateur ne parvient pas à se décharger. Pour plus d’informations, consultez Droits d’accès et de sécurité de la clé de registre et Hives du registre.
Pour plus d’informations sur l’appel de fonctions qui nécessitent des privilèges d’administrateur, consultez Exécution avec des privilèges spéciaux.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | userenv.h |
| Bibliothèque | Userenv.lib |
| DLL | Userenv.dll |