IMAPISupport::ReadReceipt

Artikel
08/18/2023

Gilt für: Outlook 2013 | Outlook 2016

Generiert einen lese- oder ungelesenen Bericht für eine Nachricht.

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

Parameter

ulFlags

[in] Eine Bitmaske von Flags, die steuert, wie der gelesene oder nicht gelesene Bericht generiert wird. Das folgende Flag kann festgelegt werden:

MAPI_NON_READ

Ein nicht gelesener Bericht wird generiert. Wenn MAPI_NON_READ nicht festgelegt ist, wird ein Lesebericht generiert.

lpReadMessage

[in] Ein Zeiger auf die Nachricht, über die der Bericht generiert werden soll.

lppEmptyMessage

[in, out] Bei eingabe zeigt lppEmptyMessage auf einen Zeiger auf eine leere Nachricht. In der Ausgabe zeigt lppEmptyMessage auf einen Zeiger auf die Berichtsnachricht.

Rückgabewert

S_OK

Der Bericht wurde erfolgreich generiert.

Hinweise

Die IMAPISupport::ReadReceipt-Methode wird nur für Nachrichtenspeicheranbieter-Unterstützungsobjekte implementiert. Nachrichtenspeicheranbieter rufen ReadReceipt auf, um MAPI anzuweisen, einen lese- oder ungelesenen Bericht für die Nachricht zu generieren, auf die der lpReadMessage-Parameter verweist.

Hinweise für Aufrufer

Rufen Sie ReadReceipt auf, wenn die eigenschaft PR_READ_RECEIPT_REQUESTED (PidTagReadReceiptRequested) festgelegt ist und eine der folgenden Bedingungen erfüllt ist:

Die Nachricht wurde gelesen.
Die Nachricht wurde verschoben.
Die Nachricht wurde kopiert.
Die IMessage::SetReadFlag-Methode der Nachricht wurde aufgerufen.

Rufen Sie ReadReceipt nicht auf, wenn eine Nachricht gelöscht wird.

Ein gelesener oder nicht gelesener Bericht sollte nur einmal für eine Nachricht gesendet werden. Verfolgen Sie die gelesenen status einer Nachricht nach, und senden Sie nicht mehrere Berichte für eine einzelne Nachricht.

Wenn der lppEmptyMessage-Parameter auf eine gültige Berichtsnachricht verweist, wenn MAPI von ReadReceipt zurückgibt, rufen Sie die IMessage::SubmitMessage-Methode auf, um die Nachricht zu senden, und lassen Sie dann den Zeiger los, indem Sie die IUnknown:s:Release-Methode aufrufen.

Wenn ReadReceipt fehlschlägt , sollte die Nachricht ohne Übermittlung freigegeben werden. Wenn Sie die gelesenen status der Nachricht speichern, können Sie versuchen, den gelesenen oder ungelesenen Bericht zu einem späteren Zeitpunkt zu generieren.

Sie können lese- und ungelesene Berichte ausblenden oder anzeigen, die von Speichern in Ihren Ordnern generiert wurden. Durch das Speichern von lese- und ungelesenen Berichten in ausgeblendeten Ordnern können Sie eine strengere Sicherheit implementieren.

Siehe auch

IMAPIFolder::DeleteMessages
IMessage::SubmitMessage
PidTagReadReceiptRequested (kanonische Eigenschaft)
IMAPISupport: IUnknown

Freigeben über