IMAPISupport::ReadReceipt

Статья
04/04/2023

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

Создает отчет для чтения или непрочитанного отчета для сообщения.

HRESULT ReadReceipt(
ULONG ulFlags,
LPMESSAGE lpReadMessage,
LPMESSAGE FAR * lppEmptyMessage
);

Параметры

ulFlags

[в] Битовая маска флагов, управляющая тем, как создается отчет для чтения или непрочитанного отчета. Можно задать следующий флаг:

MAPI_NON_READ

Создается непрочитаемый отчет. Если MAPI_NON_READ не задано, создается отчет о чтении.

lpReadMessage

[в] Указатель на сообщение, о котором должен быть создан отчет.

lppEmptyMessage

[вход, выход] При входе lppEmptyMessage указывает на указатель на пустое сообщение. В выходных данных lppEmptyMessage указывает на указатель на сообщение отчета.

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

S_OK

Отчет был успешно создан.

Замечания

Метод IMAPISupport::ReadReceipt реализован только для объектов поддержки поставщика хранилища сообщений. Поставщики хранилища сообщений вызывают ReadReceipt , чтобы указать MAPI создать отчет для чтения или непрочитанного отчета для сообщения, на которое указывает параметр lpReadMessage .

Примечания для вызывающих методов

Вызовите ReadReceipt , если свойство PR_READ_RECEIPT_REQUESTED (PidTagReadReceiptRequested) задано и выполняется одно из следующих условий:

Сообщение прочитано.
Сообщение перемещено.
Сообщение скопировано.
Был вызван метод IMessage::SetReadFlag сообщения.

Не вызывайте ReadReceipt при удалении сообщения.

Прочитанные или непрочитанные отчеты должны отправляться только один раз для сообщения. Отслеживайте состояние чтения сообщения и не отправляйте несколько отчетов для одного сообщения.

Если параметр lppEmptyMessage указывает на допустимое сообщение отчета при возврате MAPI из ReadReceipt, вызовите метод IMessage::SubmitMessage , чтобы отправить сообщение, а затем освободить указатель, вызвав его метод IUnknown:s:Release .

Если сбой ReadReceipt , сообщение должно быть освобождено без отправки. Если сохранить состояние чтения сообщения, можно попытаться создать отчет о прочтении или непрочитанном отчете позже.

Вы можете скрыть или отобразить отчеты о чтении и непрочитанных отчетах, созданных хранилищами в папках. Хранение непрочитанных и непрочитанных отчетов в скрытых папках позволяет обеспечить более жесткую безопасность.

См. также

IMAPIFolder::DeleteMessages
IMessage::SubmitMessage
Каноническое свойство PidTagReadReceiptRequested
IMAPISupport: IUnknown

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