IMAPISupport::StatusRecips
Область применения: Outlook 2013 | Outlook 2016
Создает отчеты о доставке и недоставке.
HRESULT StatusRecips(
LPMESSAGE lpMessage,
LPADRLIST lpRecipList
);
Параметры
lpMessage
[в] Указатель на сообщение, для которого должен быть создан отчет.
lpRecipList
[в] Указатель на структуру ADRLIST , которая описывает получателей сообщения, на которое указывает lpMessage.
Возвращаемое значение
S_OK
Отчет был успешно создан.
MAPI_W_ERRORS_RETURNED
В целом вызов выполнен успешно, но для этого типа получателя нет параметров получателя. При возврате этого предупреждения вызов должен быть обработан как успешный. Чтобы проверить наличие этого предупреждения, используйте макрос HR_FAILED . Дополнительные сведения см. в разделе Использование макросов для обработки ошибок.
Замечания
Для объектов поддержки поставщика транспорта реализован метод IMAPISupport::StatusRecips . Поставщики транспорта вызывают StatusRecips , чтобы запросить отправку MAPI отчета о доставке или недоставке набору из одного или нескольких получателей сообщения.
Примечания для вызывающих методов
Во время обработки сообщения можно вызвать StatusRecips несколько раз. Однако если вы вызываете StatusRecips для открытого сообщения, сделайте все возможное, чтобы собрать все сведения о доставке и недоставке для получателей сообщения и вызвать StatusRecips для этого списка получателей. Одна точка сбора важна, так как несколько вызовов StatusRecips для одного получателя могут привести к отправке нескольких идентичных отчетов.
Храните свойства, связанные с доставкой или недоставкой сообщений, в структуре ADRLIST , указанной параметром lpRecipList . Полный список обязательных и необязательных свойств для отчетов о доставке и отчетов о недоставке см. в разделах Обязательные свойства сообщения отчета и Необязательные свойства сообщения отчета.
Выделите память для структуры ADRLIST в lpRecipList с помощью функций MAPIAllocateBuffer и MAPIAllocateMore . MAPI освобождает память, вызывая функцию MAPIFreeBuffer только в том случае, если StatusRecips успешно выполняется.
Общие сведения о доставке и недоставке отчетов см. в статье Сообщения отчетов MAPI.