IFileOperation::MoveItem-Methode (shobjidl_core.h)

Artikel
08/26/2023

Deklariert ein einzelnes Element, das an ein angegebenes Ziel verschoben werden soll.

Syntax

HRESULT MoveItem(
  [in] IShellItem                 *psiItem,
  [in] IShellItem                 *psiDestinationFolder,
  [in] LPCWSTR                    pszNewName,
  [in] IFileOperationProgressSink *pfopsItem
);

Parameter

[in] psiItem

Typ: IShellItem*

Zeiger auf ein IShellItem-Objekt , das das Quellelement angibt.

[in] psiDestinationFolder

Typ: IShellItem*

Zeiger auf ein IShellItem-Objekt , das den Zielordner angibt, der das verschobene Element enthalten soll.

[in] pszNewName

Typ: LPCWSTR

Zeiger auf einen neuen Namen für das Element am neuen Speicherort. Dies ist eine mit NULL endende Unicode-Zeichenfolge und kann NULL sein. Wenn NULL, ist der Name des Zielelements identisch mit der Quelle.

[in] pfopsItem

Typ: IFileOperationProgressSink*

Zeiger auf ein IFileOperationProgressSink-Objekt, das für den Status status und Fehlerbenachrichtigungen für diesen spezifischen Verschiebungsvorgang verwendet werden soll. Wenn Sie IFileOperation::Advise für den Gesamtvorgang aufrufen, sind dort status status und Fehlerbenachrichtigungen für den Verschiebungsvorgang enthalten. Legen Sie diesen Parameter daher auf NULL fest.

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 wird das Element nicht verschoben, sondern lediglich das zu verschiebende Element deklariert. Um ein Objekt zu verschieben, müssen Sie mindestens die hier beschriebene Sequenz von Aufrufen ausführen:

Rufen Sie IFileOperation::MoveItem auf, um das Quellelement, den Zielordner und den Zielnamen zu deklarieren.
Rufen Sie IFileOperation::P erformOperations auf, um den Verschiebungsvorgang 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::MoveItems

PostMoveItem

PreMoveItem

Freigeben über