IFileOperationProgressSink：:P reCopyItem 方法 (shobjidl_core.h)

  • 项目

在每个项的复制过程开始之前执行调用方实现的操作。

语法

HRESULT PreCopyItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiItem,
  [in] IShellItem *psiDestinationFolder,
  [in] LPCWSTR    pszNewName
);

参数

[in] dwFlags

类型：DWORD

包含控制操作的标志的按位值。 有关标志说明，请参阅 TRANSFER_SOURCE_FLAGS 。

[in] psiItem

类型： IShellItem*

指向指定源项的 IShellItem 的指针。

[in] psiDestinationFolder

类型： IShellItem*

指向 IShellItem 的指针，该 IShellItem 指定要包含项目副本的目标文件夹。

[in] pszNewName

类型： LPCWSTR

指向复制后项的新名称的指针。 这是以 null 结尾的 Unicode 字符串，可以为 NULL。 如果 为 NULL，则目标项的名称与源相同。

返回值

类型： HRESULT

如果成功，则返回 S_OK，否则返回错误值。 如果出现错误值，将取消复制操作以及从调用 IFileOperation 挂起的所有后续操作。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)