IMAPISupport::CopyMessages
适用于：Outlook 2013 | Outlook 2016
将邮件从一个文件夹复制或移动到另一个文件夹。
HRESULT CopyMessages(
LPCIID lpSrcInterface,
LPVOID lpSrcFolder,
LPENTRYLIST lpMsgList,
LPCIID lpDestInterface,
LPVOID lpDestFolder,
ULONG_PTR ulUIParam,
LPMAPIPROGRESS lpProgress,
ULONG ulFlags
);
参数
lpSrcInterface
[in]指向接口标识符的指针 (IID) ，该接口表示用于访问包含要复制或移动的邮件的文件夹的接口。
lpSrcFolder
[in]指向包含要复制或移动的邮件的文件夹的指针。
lpMsgList
[in]指向标识要复制或移动的消息的条目标识符数组的指针。
lpDestInterface
[in]指向接口标识符的指针 (IID) ，该接口表示用于访问已复制或移动邮件的目标文件夹的接口。
lpDestFolder
[in]指向已复制或移动邮件的目标文件夹的指针。 此文件夹必须打开。
ulUIParam
[in]指向显示进度指示器的进度对象的指针。 如果在 lpProgress 中传递 NULL，则消息存储提供程序使用 MAPI 进度对象实现显示进度指示器。 除非在 ulFlags 中设置了 MESSAGE_DIALOG 标志，否则忽略 lpProgress 参数。
lpProgress
[in]指向显示进度指示器的进度对象的指针。 如果在 lpProgress 中传递 NULL，则消息存储提供程序使用 MAPI 进度对象实现显示进度指示器。 除非在 ulFlags 中设置了 MESSAGE_DIALOG 标志，否则忽略 lpProgress 参数。
ulFlags
[in]控制如何完成复制或移动操作的标志的位掩码。 可以设置以下标志：
MESSAGE_DIALOG
请求显示进度指示器。
MESSAGE_MOVE
应移动消息，而不是复制消息。 如果未设置MESSAGE_MOVE，则会复制消息。
返回值
S_OK
复制或移动操作成功。
MAPI_E_USER_CANCEL
用户取消了操作，通常单击对话框中的“ 取消 ”按钮。
备注
IMAPISupport：：CopyMessages 方法为消息存储提供程序支持对象实现。 消息存储提供程序可以在 IMAPIFolder：：CopyMessages 的实现中调用 IMAPISupport：：CopyMessages ，以将一个或多个邮件从一个文件夹复制或移动到另一个文件夹。 作为 IMAPISupport：：CopyMessages 调用的一部分，消息存储提供程序可以指定 MAPI 应显示进度指示器。