IXPLogon::EndMessage
Область применения: Outlook 2013 | Outlook 2016
Сообщает поставщику транспорта о том, что диспетчер очереди MAPI завершил обработку исходящего сообщения.
HRESULT EndMessage(
ULONG ulMsgRef,
ULONG FAR * lpulFlags
);
Параметры
ulMsgRef
[в] Ссылочные значения сообщения, полученные при более раннем вызове метода IXPLogon::SubmitMessage .
lpulFlags
[out] Битовая маска флагов, указывающая для диспетчера очереди MAPI, что он должен делать с сообщением. Если флаги не заданы, сообщение отправлено. Можно задать следующие флаги:
END_DONT_RESEND
Поставщик транспорта на данный момент имеет все необходимые сведения об этом сообщении. Если поставщику транспорта требуется дополнительная информация или когда он отправил сообщение, он уведомляет диспетчер очереди MAPI, вызвав метод IMAPISupport::SpoolerNotify с флагом NOTIFY_SENTDEFERRED и передав идентификатор входа сообщения.
END_RESEND_LATER
Поставщик транспорта не отправляет сообщение в текущее время по причинам, которые не являются ошибками. Поставщик транспорта должен быть вызван еще раз позже, чтобы отправить сообщение.
END_RESEND_NOW
Поставщику транспорта необходимо перезапустить сообщение, переданное ему в вызове метода IMessage::SubmitMessage .
Возвращаемое значение
S_OK
Вызов выполнен успешно и возвращает ожидаемое значение или значения.
Замечания
Средство spooler MAPI вызывает метод IXPLogon::EndMessage после завершения обработки, связанной с предоставлением сведений о расширенной доставке или о недоставке.
После возврата этого вызова значение в параметре ulMsgRef перестает быть допустимым для этого сообщения. Поставщик транспорта может повторно использовать то же значение в будущем сообщении.
Все объекты, которые поставщик транспорта открывает во время передачи сообщения, должны быть освобождены до возврата вызова EndMessage , за исключением объекта сообщения, который диспетчер spooler MAPI передает поставщику транспорта. Объект сообщения, переданный диспетчером очереди MAPI, недопустим после вызова EndMessage .