IMAPISupport::StatusRecips
Gilt für: Outlook 2013 | Outlook 2016
Generiert Übermittlungs- und Nicht-Lieferberichte.
HRESULT StatusRecips(
LPMESSAGE lpMessage,
LPADRLIST lpRecipList
);
Parameter
lpMessage
[in] Ein Zeiger auf die Nachricht, für die der Bericht generiert werden soll.
lpRecipList
[in] Ein Zeiger auf eine ADRLIST-Struktur , die die Empfänger der Nachricht beschreibt, auf die von lpMessage verwiesen wird.
Rückgabewert
S_OK
Der Bericht wurde erfolgreich generiert.
MAPI_W_ERRORS_RETURNED
Der Anruf war insgesamt erfolgreich, aber es gibt keine Empfängeroptionen für diesen Empfängertyp. Wenn diese Warnung zurückgegeben wird, sollte der Aufruf als erfolgreich behandelt werden. Verwenden Sie zum Testen auf diese Warnung das Makro HR_FAILED . Weitere Informationen finden Sie unter Verwenden von Makros für die Fehlerbehandlung.
Hinweise
Die IMAPISupport::StatusRecips-Methode wird für Transportanbieterunterstützungsobjekte implementiert. Transportanbieter rufen StatusRecips auf, um anzufordern, dass MAPI einen Übermittlungs- oder Nichtlieferungsbericht an einen Satz von einem oder mehreren Empfängern einer Nachricht sendet.
Hinweise für Aufrufer
Sie können StatusRecips während der Verarbeitung einer Nachricht mehrmals aufrufen. Wenn Sie jedoch StatusRecips für eine geöffnete Nachricht aufrufen, tun Sie Ihr Bestes, um alle Übermittlungs- und nicht lieferfreien Informationen für die Nachrichtenempfänger zu sammeln und StatusRecips für diese Empfängerliste aufzurufen. Ein einzelner Sammlungspunkt ist wichtig, da mehrere StatusRecips-Aufrufe für einen Empfänger dazu führen können, dass mehrere identische Berichte gesendet werden.
Speichern Sie Eigenschaften, die sich auf die Nachrichtenübermittlung oder nicht auf die Übermittlung beziehen, in der ADRLIST-Struktur , die durch den lpRecipList-Parameter angegeben wird. Eine vollständige Liste der erforderlichen und optionalen Eigenschaften für Übermittlungsberichte und nicht lieferfreie Berichte finden Sie unter Erforderliche Berichtsnachrichteneigenschaften und optionale Berichtsnachrichteneigenschaften.
Ordnen Sie Arbeitsspeicher für die ADRLIST-Struktur in lpRecipList zu, indem Sie die Funktionen MAPIAllocateBuffer und MAPIAllocateMore verwenden. MAPI gibt den Arbeitsspeicher durch Aufrufen der MAPIFreeBuffer-Funktion nur frei, wenn StatusRecips erfolgreich ist.
Eine Übersicht über Übermittlungs- und nicht lieferfreie Berichte finden Sie unter MAPI-Berichtsmeldungen.