Partager via

DeleteProfileA, fonction (userenv.h)

  • Article

Supprime le profil utilisateur et tous les paramètres liés à l’utilisateur de l’ordinateur spécifié. L’appelant doit disposer de privilèges d’administration pour supprimer le profil d’un utilisateur.

Syntaxe

USERENVAPI BOOL DeleteProfileA(
  [in]           LPCSTR lpSidString,
  [in, optional] LPCSTR lpProfilePath,
  [in, optional] LPCSTR lpComputerName
);

Paramètres

[in] lpSidString

Type : LPCTSTR

Pointeur vers une chaîne qui spécifie l’utilisateur SID.

[in, optional] lpProfilePath

Type : LPCTSTR

Pointeur vers une chaîne qui spécifie le chemin du profil. Si ce paramètre est NULL, la fonction obtient le chemin d’accès du Registre.

[in, optional] lpComputerName

Type : LPCTSTR

Pointeur vers une chaîne qui spécifie le nom de l’ordinateur à partir duquel le profil doit être supprimé. Si ce paramètre est NULL, le nom de l’ordinateur local est utilisé.

Remarque à partir de Windows Vista, ce paramètre doit être NULL. Si ce n’est pas le cas, cette fonction échoue avec le code d’erreur ERROR_INVALID_PARAMETER.
 

Valeur de retour

Type : BOOL

TRUE en cas de réussite ; sinon, FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

DeleteProfile peut échouer lors de l’échec de l’identificateur de sécurité (SID) du compte système local (S-1-5-18).

Note

L’en-tête userenv.h définit DeleteProfile comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence Valeur
client minimum pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge Windows 2000 Server [applications de bureau uniquement]
plateforme cible Windows
d’en-tête userenv.h
bibliothèque Userenv.lib
DLL Userenv.dll

Voir aussi

Vue d’ensemble des profils utilisateur

informations de référence sur les profils utilisateur