IMAPISupport::CopyMessages
S’applique à : Outlook 2013 | Outlook 2016
Copie ou déplace les messages d’un dossier vers un autre dossier.
HRESULT CopyMessages(
LPCIID lpSrcInterface,
LPVOID lpSrcFolder,
LPENTRYLIST lpMsgList,
LPCIID lpDestInterface,
LPVOID lpDestFolder,
ULONG_PTR ulUIParam,
LPMAPIPROGRESS lpProgress,
ULONG ulFlags
);
Paramètres
lpSrcInterface
[in] Pointeur vers l’identificateur d’interface (IID) qui représente l’interface à utiliser pour accéder au dossier qui contient les messages à copier ou déplacer.
lpSrcFolder
[in] Pointeur vers le dossier qui contient les messages à copier ou déplacer.
lpMsgList
[in] Pointeur vers un tableau d’identificateurs d’entrée qui identifient les messages à copier ou déplacer.
lpDestInterface
[in] Pointeur vers l’identificateur d’interface (IID) qui représente l’interface à utiliser pour accéder au dossier de destination des messages copiés ou déplacés.
lpDestFolder
[in] Pointeur vers le dossier de destination pour les messages copiés ou déplacés. Ce dossier doit être ouvert.
ulUIParam
[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 MESSAGE_DIALOG est défini dans 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 MESSAGE_DIALOG est défini dans ulFlags.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle la façon dont l’opération de copie ou de déplacement est effectuée. Les indicateurs suivants peuvent être définis :
MESSAGE_DIALOG
Demande l’affichage d’un indicateur de progression.
MESSAGE_MOVE
Les messages doivent être déplacés au lieu d’être copiés. Si MESSAGE_MOVE n’est pas défini, les messages sont copiés.
Valeur renvoyée
S_OK
L’opération de copie ou de déplacement a réussi.
MAPI_E_USER_CANCEL
L’utilisateur a annulé l’opération, généralement en cliquant sur le bouton Annuler dans une boîte de dialogue.
Remarques
La méthode IMAPISupport ::CopyMessages est implémentée pour les objets de prise en charge du fournisseur de magasins de messages. Les fournisseurs de magasins de messages peuvent appeler IMAPISupport ::CopyMessages dans leur implémentation de IMAPIFolder ::CopyMessages pour copier ou déplacer un ou plusieurs messages d’un dossier vers un autre. Dans le cadre de l’appel IMAPISupport ::CopyMessages , le fournisseur de magasin de messages peut spécifier que MAPI doit afficher un indicateur de progression.