IMessage::DeleteAttach
S’applique à : Outlook 2013 | Outlook 2016
Supprime une pièce jointe.
HRESULT DeleteAttach(
ULONG ulAttachmentNum,
ULONG_PTR ulUIParam,
LPMAPIPROGRESS lpProgress,
ULONG ulFlags
);
Paramètres
ulAttachmentNum
[in] Numéro d’index de la pièce jointe à supprimer. Il s’agit de la valeur de la propriété PR_ATTACH_NUM (PidTagAttachNumber) de la pièce jointe.
ulUIParam
[in] Gérez la fenêtre parente de toutes les boîtes de dialogue ou fenêtres affichées par cette méthode. Le paramètre ulUIParam est ignoré, sauf si l’indicateur ATTACH_DIALOG est défini dans le paramètre ulFlags .
lpProgress
[in] Pointeur vers un objet progress qui affiche un indicateur de progression. Si NULL est passé dans lpProgress, le fournisseur de magasin de messages affiche un indicateur de progression à l’aide de l’implémentation de l’objet de progression MAPI. Le paramètre lpProgress est ignoré, sauf si l’indicateur ATTACH_DIALOG est défini dans ulFlags.
ulFlags
[in] Masque de bits des indicateurs qui contrôle l’affichage d’une interface utilisateur. L’indicateur suivant peut être défini :
ATTACH_DIALOG
Demande l’affichage d’un indicateur de progression à mesure que l’opération se poursuit.
Valeur renvoyée
S_OK
La pièce jointe a été supprimée avec succès.
Remarques
La méthode IMessage ::D eleteAttach supprime une pièce jointe dans un message.
Une pièce jointe supprimée n’est pas supprimée définitivement tant que la méthode IMAPIProp ::SaveChanges du message n’a pas été appelée.
Remarques pour les appelants
Avant d’appeler DeleteAttach, appelez la méthode IUnknown ::Release pour la pièce jointe et chacun de ses flux.
Étant donné que la suppression d’une pièce jointe peut être un processus long, DeleteAttach fournit le mécanisme qui affiche un indicateur de progression. Vous pouvez demander l’affichage d’un indicateur de progression en passant un pointeur vers votre implémentation IMAPIProgress : IUnknown ou NULL si vous n’avez pas d’implémentation. Vous devez également spécifier un handle de fenêtre dans le paramètre ulUIParam et l’indicateur ATTACH_DIALOG dans le paramètre ulFlags .
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| AttachmentsDlg.cpp |
CAttachmentsDlg ::OnDeleteSelectedItem |
MFCMAPI utilise la méthode IMessage ::D eleteAttach pour supprimer la pièce jointe sélectionnée. |