IFileOperation::CopyItems-Methode (shobjidl_core.h)

  • Artikel

Deklariert einen Satz von Elementen, die in ein angegebenes Ziel kopiert werden sollen.

Syntax

HRESULT CopyItems(
  [in] IUnknown   *punkItems,
  [in] IShellItem *psiDestinationFolder
);

Parameter

[in] punkItems

Typ: IUnknown*

Zeiger auf das IUnknown-Objekt des IShellItemArray-, IDataObject- oder IEnumShellItems-Objekts , das die Gruppe der zu kopierenden Elemente darstellt. Sie können auch auf ein IPersistIDList-Objekt zeigen, um ein einzelnes Element darzustellen, wodurch die gleiche Funktion wie IFileOperation::CopyItem erreicht wird.

[in] psiDestinationFolder

Typ: IShellItem*

Zeiger auf ein IShellItem-Objekt , das den Zielordner angibt, der die Kopie der Elemente enthalten soll.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode kopiert die Elemente nicht, sondern deklariert lediglich die zu kopierenden Elemente. Um eine Gruppe von Elementen zu kopieren, müssen Sie mindestens die hier beschriebene Reihenfolge von Aufrufen ausführen:

  1. Rufen Sie IFileOperation::CopyItems auf, um die Quellelemente und den Zielordner zu deklarieren.
  2. Rufen Sie IFileOperation::P erformOperations auf , um den Kopiervorgang zu starten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shobjidl.h einschließen)

Weitere Informationen

IFileOperation

IFileOperation::CopyItem