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 administratifs 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 le SID utilisateur.

[in, optional] lpProfilePath

Type : LPCTSTR

Pointeur vers une chaîne qui spécifie le chemin d’accès du profil. Si ce paramètre a la valeur NULL, la fonction obtient le chemin d’accès à partir 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 a la valeur NULL, le nom de l’ordinateur local est utilisé.

Note À partir de Windows Vista, ce paramètre doit avoir la valeur NULL. Si ce n’est pas le cas, cette fonction échoue avec le code d’erreur ERROR_INVALID_PARAMETER.
 

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

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

Notes

L’en-tête userenv.h définit DeleteProfile comme un 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.

Configuration requise

   
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

Vue d’ensemble des profils utilisateur

Informations de référence sur les profils utilisateur