IFileOperation::CopyItems-Methode (shobjidl_core.h)
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:
- Rufen Sie IFileOperation::CopyItems auf, um die Quellelemente und den Zielordner zu deklarieren.
- 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) |