Поделиться через

Метод IFileOperation::MoveItem (shobjidl_core.h)

  • Статья

Объявляет один элемент, который должен быть перемещен в указанное место назначения.

Синтаксис

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

Параметры

[in] psiItem

Тип: IShellItem*

Указатель на элемент IShellItem , указывающий исходный элемент.

[in] psiDestinationFolder

Тип: IShellItem*

Указатель на элемент IShellItem , указывающий папку назначения, в которую будет входить перемещенный элемент.

[in] pszNewName

Тип: LPCWSTR

Указатель на новое имя элемента в новом расположении. Это строка Юникода с завершением NULL и может иметь значение NULL. Если значение NULL, имя конечного элемента совпадает с именем источника.

[in] pfopsItem

Тип: IFileOperationProgressSink*

Указатель на объект IFileOperationProgressSink , который будет использоваться для уведомления о состоянии выполнения и уведомления об ошибках для конкретной операции перемещения. Если вы вызываете IFileOperation::Advise для общей операции, в нее включаются уведомления о состоянии хода выполнения и уведомления об ошибках для операции перемещения, поэтому задайте для этого параметра значение NULL.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Этот метод не перемещает элемент, он просто объявляет элемент для перемещения. Чтобы переместить объект, необходимо выполнить по крайней мере последовательность вызовов, описанную здесь:

  1. Вызовите метод IFileOperation::MoveItem , чтобы объявить исходный элемент, целевую папку и имя назначения.
  2. Вызовите метод IFileOperation::P erformOperations , чтобы начать операцию перемещения.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)

См. также раздел

IFileOperation

IFileOperation::MoveItems

PostMoveItem

PreMoveItem