Last modified: July 23, 2011
Applies to: Outlook
Generates a read or nonread report for a message.
Call ReadReceipt when the PR_READ_RECEIPT_REQUESTED (PidTagReadReceiptRequested) property is set and one of the following conditions is true:
The message has been read.
The message has been moved.
The message has been copied.
The message's IMessage::SetReadFlag method has been called.
Do not call ReadReceipt when a message is deleted.
A read or nonread report should be sent only once for a message. Keep track of a message's read status and do not send multiple reports for a single message.
If the lppEmptyMessage parameter points to a valid report message when MAPI returns from ReadReceipt, call the IMessage::SubmitMessage method to send the message and then release the pointer by calling its IUnknown:s:Release method.
If ReadReceipt fails, the message should be released without being submitted. If you store the message's read status, you can attempt to generate the read or nonread report at a later time.
You can either hide or display read and nonread reports generated by stores in your folders. Storing read and nonread reports in hidden folders enables you to implement tighter security.