Freigeben über

IMAPISupport::PrepareSubmit

  • Artikel

Gilt für: Outlook 2013 | Outlook 2016

Bereitet eine Nachricht für die Übermittlung an den MAPI-Spooler vor.

HRESULT PrepareSubmit(
LPMESSAGE lpMessage,
ULONG FAR * lpulFlags
);

Parameter

lpMessage

[in] Ein Zeiger auf die vorzubereitende Nachricht.

lpulFlags

[in, out] Bei der Eingabe ist der lpulFlags-Parameter reserviert und muss 0 (null) sein. Bei der Ausgabe muss lpulFlags NULL sein.

Rückgabewert

S_OK

Die Nachricht wurde erfolgreich vorbereitet.

Hinweise

Die IMAPISupport::P repareSubmit-Methode ist für Unterstützungsobjekte des Nachrichtenspeicheranbieters implementiert. Nachrichtenspeicheranbieter rufen PrepareSubmit in ihrer Implementierung der IMessage::SubmitMessage-Methode auf, um eine Nachricht für die Übermittlung an den MAPI-Spooler vorzubereiten.

PrepareSubmit wird verwendet, um Nachrichten zu verarbeiten, deren MSGFLAG_RESEND-Flag in ihrer PR_MESSAGE_FLAGS -Eigenschaft (PidTagMessageFlags) festgelegt ist. MSGFLAG_RESEND für Nachrichten festgelegt ist, die eine Anforderung enthalten, die bei einem Fehler bei der ersten Übertragung erneut gesendet werden soll. PrepareSubmit bestimmt, welcher der Empfänger in der Empfängerliste die Nachricht erfolgreich empfangen hat und welche nicht.

Für den Zugriff auf die Empfängerliste ruft PrepareSubmit die IMessage::GetRecipientTable-Methode der Nachricht auf. Zum Abrufen der Empfängerdaten ruft PrepareSubmit die IMAPITable::QueryRows-Methode der Empfängertabelle auf. PrepareSubmit überprüft für jede Zeile in der Tabelle die eigenschaft PR_RECIPIENT_TYPE (PidTagRecipientType) und führt eine der folgenden Aktionen aus:

  • Wenn das flag MAPI_SUBMITTED festgelegt ist, löscht PrepareSubmit das Flag und legt die eigenschaft PR_RESPONSIBILITY (PidTagResponsibility) auf FALSE fest.

  • Wenn das flag MAPI_SUBMITTED nicht festgelegt ist, ändert PrepareSubmitPR_RECIPIENT_TYPE in MAPI_P1 und legt PR_RESPONSIBILITY auf TRUE fest.

Hinweise für Aufrufer

Bevor Sie PrepareSubmit aufrufen, stellen Sie sicher, dass Sie die IMAPISupport::SpoolerNotify-Methode aufgerufen und das NOTIFY_READYTOSEND-Flag im ulFlags-Parameter festgelegt haben. Der SpoolerNotify-Aufruf muss einmal pro Sitzung vor dem Aufruf von PrepareSubmit erfolgen. SpoolerNotify synchronisiert den MAPI-Spooler und stellt sicher, dass alle erforderlichen Transportanbieter angemeldet und ihre Adresstypen registriert werden.

Siehe auch

IMAPIFolder::GetMessageStatus
IMessage::SubmitMessage
IMAPISupport: IUnknown