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
[в] Указатель на идентификатор интерфейса (IID), представляющий интерфейс, используемый для доступа к папке, содержащей сообщения для копирования или перемещения.
lpSrcFolder
[в] Указатель на папку, содержащую сообщения для копирования или перемещения.
lpMsgList
[в] Указатель на массив идентификаторов входа, определяющих копируемые или перемещаемые сообщения.
lpDestInterface
[в] Указатель на идентификатор интерфейса (IID), представляющий интерфейс, используемый для доступа к целевой папке для скопированных или перемещенных сообщений.
lpDestFolder
[в] Указатель на папку назначения для скопированных или перемещенных сообщений. Эта папка должна быть открыта.
ulUIParam
[в] Указатель на объект выполнения, отображающий индикатор хода выполнения. Если в lpProgress передается значение NULL, поставщик хранилища сообщений отображает индикатор хода выполнения с помощью реализации объекта хода выполнения MAPI. Параметр lpProgress игнорируется, если флаг MESSAGE_DIALOG не установлен в ulFlags.
lpProgress
[в] Указатель на объект выполнения, отображающий индикатор хода выполнения. Если в lpProgress передается значение NULL, поставщик хранилища сообщений отображает индикатор хода выполнения с помощью реализации объекта хода выполнения MAPI. Параметр lpProgress игнорируется, если флаг MESSAGE_DIALOG не установлен в ulFlags.
ulFlags
[в] Битовая маска флагов, управляющая выполнением операции копирования или перемещения. Можно задать следующие флаги:
MESSAGE_DIALOG
Запрашивает отображение индикатора хода выполнения.
MESSAGE_MOVE
Сообщения должны быть перемещены, а не скопированы. Если MESSAGE_MOVE не задано, сообщения копируются.
Возвращаемое значение
S_OK
Операция копирования или перемещения прошла успешно.
MAPI_E_USER_CANCEL
Пользователь отменил операцию, обычно нажав кнопку Отмена в диалоговом окне.
Замечания
Метод IMAPISupport::CopyMessages реализован для объектов поддержки поставщика хранилища сообщений. Поставщики хранилища сообщений могут вызывать IMAPISupport::CopyMessages в реализации IMAPIFolder::CopyMessages для копирования или перемещения одного или нескольких сообщений из одной папки в другую. В рамках вызова IMAPISupport::CopyMessages поставщик хранилища сообщений может указать, что MAPI должен отображать индикатор хода выполнения.