IFileOperation::MoveItems-Methode (shobjidl_core.h)

  • Artikel

Deklariert einen Satz von Elementen, die an ein angegebenes Ziel verschoben werden sollen.

Syntax

HRESULT MoveItems(
  [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 verschiebenden Elemente darstellt. Sie können auch auf ein IPersistIDList-Objekt verweisen, um ein einzelnes Element darzustellen, wodurch die gleiche Funktion wie IFileOperation::MoveItem erreicht wird.

[in] psiDestinationFolder

Typ: IShellItem*

Zeiger auf ein IShellItem-Objekt , das den Zielordner angibt, der die verschobenen 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

Mit dieser Methode werden die Elemente nicht verschoben, sondern lediglich die zu verschiebenden Elemente deklariert. Um eine Gruppe von Elementen zu verschieben, müssen Sie mindestens die hier beschriebene Reihenfolge von Aufrufen ausführen:

  1. Rufen Sie IFileOperation::MoveItems auf, um die Quelldateien oder Ordner und den Zielordner zu deklarieren.
  2. Rufen Sie IFileOperation::P erformOperations auf, um den Verschiebungsvorgang zu starten.

Anforderungen

   
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::MoveItem