IXPLogon::EndMessage
Gilt für: Outlook 2013 | Outlook 2016
Informiert den Transportanbieter darüber, dass der MAPI-Spooler seine Verarbeitung für eine ausgehende Nachricht abgeschlossen hat.
HRESULT EndMessage(
ULONG ulMsgRef,
ULONG FAR * lpulFlags
);
Parameter
ulMsgRef
[in] Ein nachrichtenspezifischer Verweiswert, der in einem früheren Aufruf der IXPLogon::SubmitMessage-Methode abgerufen wurde.
lpulFlags
[out] Eine Bitmaske von Flags, die dem MAPI-Spooler angibt, was er mit der Nachricht tun soll. Wenn keine Flags festgelegt sind, wurde die Nachricht gesendet. Die folgenden Flags können festgelegt werden:
END_DONT_RESEND
Der Transportanbieter verfügt vorerst über alle benötigten Informationen zu dieser Nachricht. Wenn der Transportanbieter weitere Informationen benötigt oder die Nachricht gesendet hat, benachrichtigt er den MAPI-Spooler, indem er die IMAPISupport::SpoolerNotify-Methode mit dem NOTIFY_SENTDEFERRED-Flag aufruft und den Eintragsbezeichner der Nachricht übergibt.
END_RESEND_LATER
Der Transportanbieter sendet die Nachricht nicht zum aktuellen Zeitpunkt aus Gründen, die keine Fehlerbedingungen sind. Der Transportanbieter sollte später erneut aufgerufen werden, um die Nachricht zu senden.
END_RESEND_NOW
Der Transportanbieter muss die nachricht neu starten, die in einem IMessage::SubmitMessage-Methodenaufruf an ihn übergeben wurde.
Rückgabewert
S_OK
Der Aufruf war erfolgreich und hat den erwarteten Wert oder die erwarteten Werte zurückgegeben.
Hinweise
Der MAPI-Spooler ruft die IXPLogon::EndMessage-Methode auf, nachdem er die Verarbeitung abgeschlossen hat, die für die Bereitstellung erweiterter Übermittlungs- oder nicht lieferrelevanter Informationen erforderlich ist.
Sobald dieser Aufruf zurückgegeben wird, ist der Wert im ulMsgRef-Parameter für diese Nachricht nicht mehr gültig. Der Transportanbieter kann denselben Wert für eine zukünftige Nachricht wiederverwenden.
Alle Objekte, die der Transportanbieter während der Übertragung einer Nachricht öffnet, sollten vor der Rückgabe des EndMessage-Aufrufs freigegeben werden, mit Ausnahme des Nachrichtenobjekts, das der MAPI-Spooler an den Transportanbieter übergibt. Das vom MAPI-Spooler übergebene Nachrichtenobjekt ist nach dem EndMessage-Aufruf ungültig.