IMAPISupport::CopyMessages
Gilt für: Outlook 2013 | Outlook 2016
Kopiert oder verschiebt Nachrichten aus einem Ordner in einen anderen Ordner.
HRESULT CopyMessages(
LPCIID lpSrcInterface,
LPVOID lpSrcFolder,
LPENTRYLIST lpMsgList,
LPCIID lpDestInterface,
LPVOID lpDestFolder,
ULONG_PTR ulUIParam,
LPMAPIPROGRESS lpProgress,
ULONG ulFlags
);
Parameter
lpSrcInterface
[in] Ein Zeiger auf den Schnittstellenbezeichner (Interface Identifier, IID), der die Schnittstelle darstellt, die für den Zugriff auf den Ordner verwendet werden soll, der die zu kopierenden oder zu verschiebenden Nachrichten enthält.
lpSrcFolder
[in] Ein Zeiger auf den Ordner, der die zu kopierenden oder zu verschiebenden Nachrichten enthält.
lpMsgList
[in] Ein Zeiger auf ein Array von Eingabebezeichnern, die die zu kopierenden oder zu verschiebenden Nachrichten identifizieren.
lpDestInterface
[in] Ein Zeiger auf den Schnittstellenbezeichner (Interface Identifier, IID), der die Schnittstelle darstellt, die für den Zugriff auf den Zielordner für die kopierten oder verschobenen Nachrichten verwendet werden soll.
lpDestFolder
[in] Ein Zeiger auf den Zielordner für die kopierten oder verschobenen Nachrichten. Dieser Ordner muss geöffnet sein.
ulUIParam
[in] Ein Zeiger auf ein Statusobjekt, das eine Statusanzeige anzeigt. Wenn NULL in lpProgress übergeben wird, zeigt der Nachrichtenspeicheranbieter mithilfe der MAPI-Statusobjektimplementierung eine Statusanzeige an. Der lpProgress-Parameter wird ignoriert, es sei denn, das flag MESSAGE_DIALOG ist in ulFlags festgelegt.
lpProgress
[in] Ein Zeiger auf ein Statusobjekt, das eine Statusanzeige anzeigt. Wenn NULL in lpProgress übergeben wird, zeigt der Nachrichtenspeicheranbieter mithilfe der MAPI-Statusobjektimplementierung eine Statusanzeige an. Der lpProgress-Parameter wird ignoriert, es sei denn, das flag MESSAGE_DIALOG ist in ulFlags festgelegt.
ulFlags
[in] Eine Bitmaske von Flags, die steuert, wie der Kopier- oder Verschiebungsvorgang ausgeführt wird. Die folgenden Flags können festgelegt werden:
MESSAGE_DIALOG
Fordert die Anzeige einer Statusanzeige an.
MESSAGE_MOVE
Die Nachrichten sollten verschoben und nicht kopiert werden. Wenn MESSAGE_MOVE nicht festgelegt ist, werden die Nachrichten kopiert.
Rückgabewert
S_OK
Der Kopier- oder Verschiebungsvorgang war erfolgreich.
MAPI_E_USER_CANCEL
Der Benutzer hat den Vorgang in der Regel abgebrochen, indem er in einem Dialogfeld auf die Schaltfläche Abbrechen geklickt hat.
Hinweise
Die IMAPISupport::CopyMessages-Methode ist für Nachrichtenspeicheranbieter-Unterstützungsobjekte implementiert. Nachrichtenspeicheranbieter können IMAPISupport::CopyMessages in ihrer Implementierung von IMAPIFolder::CopyMessages aufrufen, um eine oder mehrere Nachrichten aus einem Ordner in einen anderen zu kopieren oder zu verschieben. Im Rahmen des IMAPISupport::CopyMessages-Aufrufs kann der Nachrichtenspeicheranbieter angeben, dass MAPI eine Statusanzeige anzeigen soll.