IMsgStore::FinishedMsg
Gilt für: Outlook 2013 | Outlook 2016
Ermöglicht dem Nachrichtenspeicheranbieter, die Verarbeitung einer gesendeten Nachricht auszuführen. Diese Methode ist nur durch die MAPI-Warteschlange aufgerufen.
HRESULT FinishedMsg(
ULONG ulFlags,
ULONG cbEntryID,
LPENTRYID lpEntryID
);
Parameter
ulFlags
[in] Reserviert. NULL muss sein.
cbEntryID
[in] Die Byteanzahl im Eintragsbezeichner, auf die der lpEntryID-Parameter verweist.
lpEntryID
[in] Ein Zeiger auf den Eintragsbezeichner der zu verarbeitenden Nachricht.
Rückgabewert
S_OK
Die Verarbeitung der gesendeten Nachricht war erfolgreich.
MAPI_E_NO_SUPPORT
Der Nachrichtenspeicheranbieter unterstützt die Verarbeitung gesendeter Nachrichten nicht. Dieser Fehlerwert wird zurückgegeben, wenn der Aufrufer nicht der MAPI-Spooler ist.
Hinweise
Die IMsgStore::FinishedMsg-Methode führt die Verarbeitung einer gesendeten Nachricht aus. Diese Verarbeitung kann das Löschen der Nachricht, das Verschieben in einen anderen Ordner oder beide Aktionen umfassen. Die Art der Verarbeitung hängt davon ab, ob die Eigenschaften PR_DELETE_AFTER_SUBMIT (PidTagDeleteAfterSubmit) und PR_SENTMAIL_ENTRYID (PidTagSentMailEntryId) festgelegt sind.
Hinweise für Implementierer
Entsperren Sie in Ihrer Implementierung von FinishedMsg die durch lpEntryID identifizierte Nachricht, und führen Sie die entsprechende Verarbeitung aus. Die Zielnachricht ist immer gesperrt. Der MAPI-Spooler übergibt niemals den Eintragsbezeichner für eine entsperrte Nachricht an FinishedMsg.
Es ist möglich, dass weder PR_DELETE_AFTER_SUBMIT noch PR_SENTMAIL_ENTRYID festgelegt ist, beide festgelegt oder das eine oder das andere festgelegt ist. In der folgenden Tabelle wird die Aktion beschrieben, die Sie basierend auf den Einstellungen ausführen sollten:
| Eigenschaft | Wert |
|---|---|
| Wenn keine der beiden Eigenschaften festgelegt ist: |
Belassen Sie die Nachricht in dem Ordner, aus dem sie gesendet wurde (in der Regel der Postausgang). |
| Wenn beide Eigenschaften festgelegt sind: |
Verschieben Sie die Nachricht bei Bedarf in den angegebenen Ordner, und löschen Sie ihn dann. |
| Wenn PR_SENTMAIL_ENTRYID festgelegt ist: |
Verschieben Sie die Nachricht in den angegebenen Ordner. |
| Wenn PR_DELETE_AFTER_SUBMIT festgelegt ist: |
Löschen Sie die Nachricht. |
Nachdem Sie eine geeignete Aktion ausgeführt haben, rufen Sie die IMAPISupport::D oSentMail-Methode auf.