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。

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