IMsgStore::FinishedMsg

Статья
04/04/2023

Область применения: Outlook 2013 | Outlook 2016

Позволяет поставщику хранилища сообщений выполнять обработку отправленного сообщения. �� MAPI.

HRESULT FinishedMsg(
  ULONG ulFlags,
  ULONG cbEntryID,
  LPENTRYID lpEntryID
);

Параметры

ulFlags

[in] ��; �� .

cbEntryID

[в] Число байтов в идентификаторе записи, на который указывает параметр lpEntryID .

lpEntryID

[в] Указатель на идентификатор записи обрабатываемого сообщения.

Возвращаемое значение

S_OK

Обработка отправленного сообщения прошла успешно.

MAPI_E_NO_SUPPORT

Поставщик хранилища сообщений не поддерживает обработку отправленных сообщений. Это значение ошибки возвращается, если вызывающий объект не является диспетчером очереди MAPI.

Замечания

Метод IMsgStore::FinishedMsg выполняет обработку отправленного сообщения. Эта обработка может включать удаление сообщения, его перемещение в другую папку или оба действия. Тип обработки зависит от того, заданы ли свойства PR_DELETE_AFTER_SUBMIT (PidTagDeleteAfterSubmit) и PR_SENTMAIL_ENTRYID (PidTagSentMailEntryId).

Примечания для исполнителей

В реализации FinishedMsg разблокируйте сообщение, определенное lpEntryID , и выполните соответствующую обработку. Целевое сообщение всегда будет заблокировано; Диспетчер очереди MAPI никогда не передает идентификатор записи для разблокированного сообщения в FinishedMsg.

Вполне возможно, что ни PR_DELETE_AFTER_SUBMIT , ни PR_SENTMAIL_ENTRYID не заданы, не заданы оба параметра или задано одно или другое. В следующей таблице описаны действия, которые следует выполнить на основе параметров:

Свойство	Значение
Если ни один из свойств не задан:	Оставьте сообщение в папке, из которой оно было отправлено (как правило, в папке "Исходящие").
Если заданы оба свойства:	При необходимости переместите сообщение в указанную папку и удалите его.
Если PR_SENTMAIL_ENTRYID задано:	Переместите сообщение в указанную папку.
Если PR_DELETE_AFTER_SUBMIT задано:	Удалите сообщение.

Выполнив любое подходящее действие, вызовите метод IMAPISupport::D oSentMail .

См. также

IMAPISupport::DoSentMail

IMsgStore: IMAPIProp

Поделиться через