IMessage::SubmitMessage

Artikel
04/04/2023

Gilt für: Outlook 2013 | Outlook 2016

Speichert alle Eigenschaften der Nachricht und markiert die Nachricht als bereit zum Senden.

HRESULT SubmitMessage(
  ULONG ulFlags
);

Parameter

ulFlags

[in] Bitmaske von Flags, die verwendet werden, um zu steuern, wie eine Nachricht übermittelt wird. Das folgende Flag kann festgelegt werden:

FORCE_SUBMIT

MAPI sollte die Nachricht sofort übermitteln. Dieses Flag wird derzeit nicht verwendet.

Rückgabewert

S_OK

Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.

MAPI_E_NO_RECIPIENTS

Die Empfängertabelle der Nachricht ist leer.

Hinweise

Die IMessage::SubmitMessage-Methode markiert eine Nachricht als bereit für die Übertragung. MAPI übergibt Nachrichten an das zugrunde liegende Messagingsystem in der Reihenfolge, in der sie zum Senden markiert sind. Aufgrund dieser Funktionalität kann eine Nachricht einige Zeit in einem Nachrichtenspeicher verbleiben, bevor das zugrunde liegende Messagingsystem die Verantwortung dafür übernehmen kann. Die Reihenfolge des Empfangs am Ziel befindet sich im Steuerelement des zugrunde liegenden Messagingsystems und stimmt nicht unbedingt mit der Reihenfolge überein, in der Nachrichten gesendet wurden.

Hinweise für Implementierer

Rufen Sie die IMAPIProp::SaveChanges-Methode der Nachricht auf, um sie zu speichern, und überprüfen Sie dann die PR_MESSAGE_FLAGS (PidTagMessageFlags)-Eigenschaft der Nachricht. Wenn das MSGFLAG_RESEND-Flag festgelegt ist, rufen Sie IMAPISupport::P repareSubmit auf. PrepareSubmit aktualisiert den Empfängertyp und die PR_RESPONSIBILITY -Eigenschaft (PidTagResponsibility) für alle Empfänger in der erneut gesendeten Nachricht.

Hinweise für Aufrufer

Wenn SubmitMessage zurückgegeben wird, sind alle Zeiger auf die Nachricht und die zugehörigen Unterobjekte Nachrichten, Ordner, Anlagen, Datenströme, Tabellen usw. nicht mehr gültig. MAPI lässt keine weiteren Vorgänge für diese Zeiger zu, mit Ausnahme des Aufrufs ihrer IUnknown::Release-Methoden . MAPI ist so konzipiert, dass Sie nach dem Aufruf von SubmitMessage die Nachricht und alle zugehörigen Unterobjekte freigeben sollten. Wenn SubmitMessage jedoch einen Fehlerwert zurückgibt, der auf fehlende oder ungültige Informationen hinweist, bleibt die Nachricht geöffnet, und die Zeiger bleiben gültig.

Um einen Sendevorgang abzubrechen, rufen Sie einen Zeiger auf die eigenschaft PR_ENTRYID (PidTagEntryId) der Nachricht ab, und speichern Sie diesen, bevor die Nachricht gesendet wird. Da der Eintragsbezeichner einer Nachricht nach dem Senden der Nachricht ungültig wird, muss sie vor dem Aufrufen von SubmitMessage gespeichert werden. Um das Senden abzubrechen, verweisen Sie mit dem LpEntryId-Parameter auf diesen Eintragsbezeichner, und rufen Sie IMsgStore::AbortSubmit auf.