IMAPIMessageSite::MoveMessage
Gilt für: Outlook 2013 | Outlook 2016
Verschiebt die aktuelle Nachricht in einen Ordner.
HRESULT MoveMessage(
LPFOLDER pFolderDestination,
LPMAPIVIEWCONTEXT pViewContext,
LPCRECT prcPosRect
);
Parameter
pFolderDestination
[in] Ein Zeiger auf den Ordner, in den die Nachricht verschoben werden soll.
pViewContext
[in] Ein Zeiger auf ein Ansichtskontextobjekt.
prcPosRect
[in] Ein Zeiger auf eine RECT-Struktur , die die Fenstergröße und -position des aktuellen Formulars enthält. Das nächste angezeigte Formular verwendet ebenfalls dieses Fensterrechteck.
Rückgabewert
S_OK
Der Aufruf erfolgreich ausgef�hrt und der erwartete Wert oder Werte zur�ckgegeben hat.
MAPI_E_NO_SUPPORT
Der Vorgang wird von dieser Nachrichtenwebsite nicht unterstützt.
Hinweise
Formularobjekte rufen die IMAPIMessageSite::MoveMessage-Methode auf, um die aktuelle Nachricht in einen neuen Ordner zu verschieben.
Hinweise für Implementierer
Die Implementierung von MoveMessage eines Formular-Viewers muss die IMAPIViewContext::ActivateNext-Methode aufrufen und dabei das VCDIR_MOVE Flag übergeben, bevor die Nachricht tatsächlich in einen neuen Ordner verschoben wird. Um die RECT-Struktur abzurufen, die vom Fenster eines Formulars verwendet wird, rufen Sie die Windows GetWindowRect-Funktion auf.
Eine Liste der Schnittstellen im Zusammenhang mit Formularservern finden Sie unter MAPI-Formularschnittstellen.
Hinweise für Aufrufer
Nach der Rückgabe von MoveMessage müssen Formulare nach einer aktuellen Nachricht suchen und sich dann selbst verwerfen, wenn keine vorhanden ist.
MFCMAPI-Referenz
Einen MFCMAP-Beispielcode finden Sie in der folgenden Tabelle.
| Datei | Funktion | Kommentar |
|---|---|---|
| MyMAPIFormViewer.cpp |
CMyMAPIFormViewer::MoveMessage |
Nicht implementiert. |
Siehe auch
IMAPIViewContext::ActivateNext