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
Für das aufrufende Formular ist derzeit keine Nachricht vorhanden.
Hinweise
Formulare rufen die IMAPIMessageSite::GetMessage-Methode auf, um eine Nachrichtenschnittstelle für die aktuelle Nachricht abzurufen. Die aktuelle Nachricht ist dieselbe Nachricht, die zuvor in den Methoden IPersistMessage::InitNew, IPersistMessage::Load oder IPersistMessage::SaveCompleted ü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 er verfügbar ist. |
Siehe auch
IPersistMessage::HandsOffMessage
IPersistMessage::SaveCompleted