IProfAdmin::DeleteProfile
S’applique à : Outlook 2013 | Outlook 2016
Supprime un profil.
HRESULT DeleteProfile(
LPSTR lpszProfileName,
ULONG ulFlags
);
Paramètres
lpszProfileName
[in] Pointeur vers le nom du profil à supprimer.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la suppression d’un profil. L’indicateur suivant peut être défini :
MAPI_APP_PROFILE
Autorise la suppression d’un profil « application ». Cet indicateur doit être défini si le profil à supprimer est un profil « application ».
Cet indicateur peut ne pas être reconnu ou pris en charge dans toutes les implémentations MAPI.
Valeur renvoyée
S_OK
Le profil a été supprimé avec succès.
MAPI_E_NO_ACCESS
Le profil est un profil « application » et l’indicateur MAPI_APP_PROFILE n’a pas été défini.
MAPI_E_NOT_FOUND
Le profil spécifié n’existe pas.
Remarques
La méthode IProfAdmin ::D eleteProfile supprime un profil. Si le profil à supprimer est en cours d’utilisation lors de l’appel de DeleteProfile , DeleteProfile retourne S_OK mais ne supprime pas immédiatement le profil. Au lieu de cela, DeleteProfile marque le profil pour la suppression et le supprime une fois qu’il n’est plus utilisé, lorsque toutes ses sessions actives sont terminées.
La fonction de point d’entrée pour chaque service de message dans le profil est appelée avec la valeur MSG_SERVICE_DELETE définie dans le paramètre ulContext . Tout d’abord, la fonction supprime le service, puis elle supprime la section du profil du service. La fonction de point d’entrée du service de message n’est plus appelée après la suppression du service.
Aucun mot de passe n’est requis pour supprimer un profil.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| MAPIProfileFunctions.cpp |
HrRemoveProfile |
MFCMAPI utilise la méthode IProfAdmin ::D eleteProfile pour supprimer le profil sélectionné. |