IPersistMessage::Load

Artikel
04/04/2023

Gilt für: Outlook 2013 | Outlook 2016

Lädt das Formular für eine angegebene Nachricht.

HRESULT Load(
  LPMESSAGESITE pMessageSite,
  LPMESSAGE pMessage,
  ULONG ulMessageStatus,
  ULONG ulMessageFlags
);

Parameter

pMessageSite

[in] Ein Zeiger auf die Nachrichtenwebsite für das zu ladende Formular.

pMessage

[in] Ein Zeiger auf die Nachricht, für die das Formular geladen werden soll.

ulMessageStatus

[in] Eine Bitmaske von clientdefinierten oder vom Anbieter definierten Flags, die aus der eigenschaft PR_MSG_STATUS (PidTagMessageStatus) der Nachricht kopiert wurden und Informationen zum Status der Nachricht bereitstellen.

ulMessageFlags

[in] Eine Bitmaske von Flags, die aus der PR_MESSAGE_FLAGS -Eigenschaft (PidTagMessageFlags) der Nachricht kopiert wurde, die weitere Informationen zum Status der Nachricht bereitstellen.

Rückgabewert

S_OK

Das Formular wurde erfolgreich geladen.

Hinweise

Formularanzeigen rufen die IPersistMessage::Load-Methode auf, um ein Formular für eine vorhandene Nachricht zu laden.

Hinweise für Implementierer

Load wird nur aufgerufen, wenn sich ein Formular in einem der folgenden Zustände befindet:

Wenn ein Formular-Viewer Load aufruft, während sich das Formular in einem anderen Zustand befindet, gibt die Methode E_UNEXPECTED zurück.

Wenn Ihr Formular einen Verweis auf eine andere aktive Nachrichtenwebsite als die an Load übergebene hat, geben Sie die ursprüngliche Website frei, da sie nicht mehr verwendet wird. Speichern Sie die Zeiger auf die Nachrichtenwebsite und die Nachricht aus den Parametern pMessageSite und pMessage , und rufen Sie die IUnknown::AddRef-Methoden beider Objekte auf, um ihre Verweisanzahl zu erhöhen.

Nachdem AddRef abgeschlossen wurde, speichern Sie die Eigenschaften aus den Parametern ulMessageStatus und ulMessageFlags im Formular. Wechseln Sie das Formular vor der Anzeige in den Normalzustand , und benachrichtigen Sie registrierte Viewer, indem Sie ihre IMAPIViewAdviseSink::OnNewMessage-Methoden aufrufen.

Wenn keine Fehler auftreten, geben Sie S_OK zurück.