Fonction DeleteAppContainerProfile (userenv.h)
Supprime le profil par utilisateur et par application spécifié.
Syntaxe
USERENVAPI HRESULT DeleteAppContainerProfile(
[in] PCWSTR pszAppContainerName
);
Paramètres
[in] pszAppContainerName
Nom donné au profil dans l’appel à la fonction CreateAppContainerProfile . Cette chaîne contient au maximum 64 caractères et s’intègre au modèle décrit par l’expression régulière « [-_. A-Za-z0-9]+ ».
Valeur retournée
Si cette fonction réussit, elle retourne un code HRESULT standard, y compris les éléments suivants :
| Code de retour | Description |
|---|---|
|
Si la méthode est appelée à partir d’un conteneur d’application. |
|
Le profil a été supprimé avec succès. |
|
Si le nom du conteneur est NULL ou s’il dépasse la limite de longueur spécifiée. |
Remarques
Pour garantir les meilleurs résultats, fermez tous les handles de fichiers dans les emplacements de stockage des profils avant d’appeler la fonction DeleteAppContainerProfile . Sinon, cette fonction risque de ne pas pouvoir supprimer complètement les emplacements de stockage du profil.
Cette fonction supprime le profil de l’utilisateur actuel. Pour supprimer le profil d’un autre utilisateur, vous devez emprunter l’identité de cet utilisateur.
Si la fonction échoue, le status du profil n’est pas déterminé et vous devez appeler à nouveau DeleteAppContainerProfile pour terminer l’opération.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | userenv.h |
| Bibliothèque | Userenv.lib |
| DLL | Userenv.dll |