IMAPIMessageSite::GetMessage

Gilt für: Outlook 2013 | Outlook 2016

Gibt die aktuelle Nachricht zurück.

HRESULT GetMessage(
  LPMESSAGE FAR * ppmsg
);

Parameter

ppmsg

[out] Ein Zeiger auf einen Zeiger auf die zurückgegebene Schnittstelle für die Nachricht.

Rückgabewert

S_OK

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

S_FALSE

Derzeit existiert keine Nachricht für das aufrufende Formular.

Hinweise

Formulare rufen die IMAPIMessageSite::GetMessage-Methode auf, um eine Nachrichtenschnittstelle für die aktuelle Nachricht abzurufen. Die aktuelle Nachricht entspricht der Nachricht, die zuvor in der IPersistMessage::InitNew, IPersistMessage::Loadoder IPersistMessage::SaveCompleted-Methode übergeben wurde.

GetMessage gibt S_FALSE zurück, wenn derzeit keine Nachricht vorhanden ist. Dieser Zustand kann nach Aufrufen der IPersistMessage::HandsOffMessage-Methode oder vor dem nächsten Aufruf von IPersistMessage::Load oder IPersistMessage::SaveCompleted auftreten.

Eine Liste der Schnittstellen im Zusammenhang mit Formularservern finden Sie unter MAPI-Formularschnittstellen.

MFCMAPI-Referenz

Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.

Datei	Funktion	Kommentar
MyMAPIFormViewer.cpp	CMyMAPIFormViewer::GetSession	MFCMAPI verwendet die IMAPIMessageSite::GetMessage-Methode, um den aktuell zwischengespeicherten Nachrichtenzeiger zurückzugeben, sofern verfügbar.

Siehe auch

IPersistMessage::HandsOffMessage

IPersistMessage::InitNew

IPersistMessage : IUnknown

IPersistMessage::Load

IPersistMessage::SaveCompleted

IMAPIMessageSite : IUnknown

MFCMAPI (engl.) als ein Codebeispiel

MAPI-Formularschnittstellen