IMAPIMessageSite::CopyMessage

Artikel
03/16/2024

Gilt für: Outlook 2013 | Outlook 2016

Kopiert die aktuelle Nachricht in einen Ordner.

HRESULT CopyMessage(
  LPMAPIFOLDER pFolderDestination
);

Parameter

pFolderDestination

[in] Ein Zeiger auf den Ordner, in den die Nachricht kopiert werden soll.

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

Form-Objekte rufen die IMAPIMessageSite::CopyMessage-Methode auf, um die aktuelle Nachricht in einen neuen Ordner zu kopieren. CopyMessage ändert die Nachricht, die dem Benutzer derzeit angezeigt wird, nicht, und es wird keine Schnittstelle für die neu erstellte Nachricht an das Formular zurückgegeben.

Hinweise für Implementierer

Eine typische Implementierung der CopyMessage-Methode führt die folgenden Aufgaben aus:

Erstellt eine neue Nachricht für die aktuelle Nachricht, in die kopiert werden soll.
Ruft die IPersistMessage::Save-Methode mit einem Zeiger auf die neue Nachricht im pMessage-Parameter und FALSE im fSameAsLoad-Parameter auf.
Ruft die IPersistMessage::SaveCompleted-Methode auf und übergibt NULL im pMessage-Parameter .
Ruft die IMAPIProp::SaveChanges-Methode für die neue Nachricht auf.