MAPI-Berichtsmeldungen
Gilt für: Outlook 2013 | Outlook 2016
Berichtsnachrichten, die status Informationen zu einer Nachricht an den Absender enthalten.
Es gibt zwei allgemeine Arten von Berichtsnachrichten:
Lesen sie status Berichte.
Übermittlung status Berichte.
Lesen von Statusberichten
Lesen status Berichte werden von Nachrichtenspeicheranbietern über einen Aufruf der IMAPISupport::ReadReceipt-Methode initiiert und an den Empfänger gesendet, der durch den Eintragsbezeichner in der eigenschaft PR_REPORT_ENTRYID (PidTagReportEntryId) dargestellt wird. Lese- status Berichte werden nicht automatisch generiert. Clientanwendungen, die sie empfangen möchten, müssen sie explizit anfordern.
Ein Lesebericht gibt an, dass das Leseflag einer Nachricht festgelegt wurde. Dies kann auftreten, wenn die Nachricht geöffnet, gedruckt, verschoben oder kopiert wird. Ob ein Nachrichtenspeicheranbieter als Reaktion auf einen Verschiebe- oder Kopiervorgang einen Lesebericht generiert, hängt davon ab, wohin die Nachricht geht. Wenn er in einen anderen Nachrichtenspeicher verschoben oder kopiert wird, wird höchstwahrscheinlich immer ein Lesebericht gesendet. Wenn er in den aktuellen Nachrichtenspeicher verschoben oder kopiert wird, wird möglicherweise ein Lesebericht gesendet oder nicht.
Ein nicht gelesener Bericht gibt an, dass das Leseflag einer Nachricht nicht festgelegt ist und dass die Nachricht weder vor dem Ablegen im Ordner "Gelöschte Elemente" noch vor ablaufen eines Zeitlimits geöffnet wurde. Clients können die IMessage::SetReadFlag - oder IMAPIFolder::SetReadFlags-Methode aufrufen, um das Leseflag einer Nachricht festzulegen oder zu löschen.
Übermittlungsstatusberichte
Übermittlung status wird in einem Übermittlungsbericht widergespiegelt, der gesendet wird, wenn eine Nachricht den beabsichtigten Empfänger erreicht hat, und in einem nicht übermittelten Bericht, der gesendet wird, wenn eine Nachricht einen Empfänger nicht erreichen konnte. Übermittlung status Berichte werden an den Empfänger gesendet, der durch den Eintragsbezeichner in der PR_REPORT_ENTRYID-Eigenschaft dargestellt wird, oder an den Absender, wenn diese Eigenschaft nicht vorhanden ist.
Übermittlungsberichte werden nur auf Anforderung gesendet und enthalten nicht die ursprüngliche Nachricht. Nicht übermittelte Berichte werden automatisch gesendet, es sei denn, es wird eine Anforderung zum Unterdrücken dieser Berichte gestellt. Nicht lieferfähige Berichte enthalten die ursprüngliche Nachricht als Anlage, damit der Empfänger des Berichts die Nachricht erneut senden kann, falls die Zustellung blockiert wird, kein Problem mehr darstellt. Die angefügte Nachricht ähnelt der ursprünglichen Nachricht, wie sie vorhanden war, als die IMessage::SubmitMessage-Methode aufgerufen wurde, um sie anfänglich zu senden.
Ein oder mehrere Übermittlungs- status Berichte werden von Transportanbietern generiert, wenn sie die IMAPISupport::StatusRecips-Methode aufrufen. Transportanbieter erstellen eine Liste der Empfänger für eine Nachricht. Ob ein Empfänger einen Bericht empfängt und welche Art von Bericht generiert wird, hängt von Folgendem ab:
Übermittlungsberichte gehen an Empfänger, die die eigenschaft PR_ORIGINATOR_DELIVERY_REPORT_REQUESTED (PidTagOriginatorDeliveryReportRequested) auf TRUE festlegen, bevor die Nachricht im Nachrichtenspeicher abgelegt wurde.
Nondelivery-Berichte gehen an Empfänger, die die eigenschaft PR_ORIGINATOR_NON_DELIVERY_REPORT_REQUESTED (PidTagOriginatorNonDeliveryReportRequested) nicht auf FALSE festgelegt haben.
Fast alle Informationen, die zum Anzeigen eines nicht vollständigen Berichts erforderlich sind, sind in der Empfängertabelle der angefügten Nachricht enthalten. Einige Eigenschaften stammen aus dem Bericht selbst. Für Übermittlungsberichte sind die erforderlichen Informationen in der Empfängertabelle des Berichts und in einigen Berichtseigenschaften enthalten.
Berichte sind Nachrichten mit unterschiedlichen Nachrichtenklassen, die auf der Klasse der gesendeten Nachricht basieren. Die meisten Dienstanbieter verwenden eine Benennungskonvention, bei der die Nachrichtenklasse aus mehreren Teilen besteht, die durch Punkte getrennt sind. Der erste Teil ist "Bericht", und der letzte Teil ist eine Konstante, die den Berichtstyp darstellt. Der mittlere Teil ist für die Klasse der gesendeten Nachricht reserviert. Da z. B. ein Übermittlungsbericht die konstante Notfallwiederherstellung verwendet, die Nachrichtenklasse für einen Übermittlungsbericht über ein IPM. Die Notiznachricht lautet Report.IPM.Note.DR.
In der folgenden Tabelle sind die Konstanten aufgeführt, die die Berichtstypen darstellen.
| Berichttyp | Konstante, die in der Nachrichtenklasse verwendet wird |
|---|---|
| Lesen |
IPNRN |
| Nicht gelesen |
IPNNRN |
| Übermittlung |
DR |
| Nondelivery |
UNZUSTELLBARKEITSBERICHT |
Interaktive Clients können Berichtsmeldungen mithilfe von Standardformularen anzeigen, die von MAPI bereitgestellt werden, oder mithilfe von benutzerdefinierten Formularen, die beim Formular-Manager für die Nachrichtenklasse des Berichts registriert wurden. Clients, die einen Nichtdeleivery-Bericht für ein IPM erhalten. Eine Hinweismeldung kann beispielsweise das MAPI-Standardformular anzeigen, das eine Liste der fehlgeschlagenen Empfänger und einen vorgeschlagenen Grund für den Fehler enthält. Das Formular ermöglicht es dem Benutzer auch, die Nachricht bei Bedarf erneut zu senden.