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 的指针，该 IShellItem 指定要包含移动项的目标文件夹。

[in] pszNewName

类型： LPCWSTR

指向项目在新位置的新名称的指针。 这是以 null 结尾的 Unicode 字符串，可以为 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
标头 shobjidl_core.h (包括 Shobjidl.h)

另请参阅

IFileOperation

IFileOperation：：MoveItems

PostMoveItem

PreMoveItem