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

Voir aussi

LoadUserProfile

PROFILEINFO

Vue d’ensemble des profils utilisateur

Informations de référence sur les profils utilisateur