IFileOperation：：RenameItems 方法 (shobjidl_core.h)

  • 项目

声明一组要赋予新显示名称的项。 所有项的名称都相同。

语法

HRESULT RenameItems(
  [in] IUnknown *pUnkItems,
  [in] LPCWSTR  pszNewName
);

参数

[in] pUnkItems

类型： IUnknown*

指向 IShellItemArray、IDataObject 或 IEnumShellItems 对象的 IUnknown 的指针，该对象表示要重命名的项组。 还可以指向 IPersistIDList 对象来表示单个项，从而有效地完成与 IFileOperation：：RenameItem 相同的功能。

[in] pszNewName

类型： LPCWSTR

指向项的新显示名称的指针。 这是以 null 结尾的 Unicode 字符串。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

注解

如果 pUnkItems 集合中的多个项位于同一文件夹中，则重命名的文件会在括号中追加一个数字来区分它们，例如 newfile (1) .txt，newfile (2) .txt，newfile (3) .txt。

此方法不会重命名项，而只是声明要重命名的项。 若要重命名一组对象，必须至少进行此处详述的调用序列：

  1. 调用 IFileOperation：：RenameItems 以声明源文件或文件夹以及新名称。
  2. 调用 IFileOperation：:P erformOperations 以开始重命名操作。

要求

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

另请参阅

IFileOperation

IFileOperation：：RenameItem