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 MoveMessage eines Formular-Viewers muss die IMAPIViewContext::ActivateNext--Methode aufrufen und 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-Funktion GetWindowRect 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 schließen, 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

IMAPIMessageSite : IUnknown

MFCMAPI (engl.) als ein Codebeispiel

MAPI-Formularschnittstellen