ITransferSource：：RenameItem 方法 (shobjidl_core.h)

  • 项目

更改项的名称，返回具有新名称的 IShellItem 。

语法

HRESULT RenameItem(
  [in]  IShellItem            *psiSource,
  [in]  LPCWSTR               pszNewName,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] IShellItem            **ppsiNewDest
);

参数

[in] psiSource

类型： IShellItem*

指向要重命名的 IShellItem 对象的指针。

[in] pszNewName

类型： LPCWSTR

指向包含新名称的以 null 结尾的 Unicode 字符串的指针。

[in] flags

类型： TRANSFER_SOURCE_FLAGS

控制文件操作的标志。 一个或多个 TRANSFER_SOURCE_FLAGS 常量。

[out] ppsiNewDest

类型： IShellItem**

此方法返回时，包含指向 IShellItem 对象的指针的地址。

返回值

类型： HRESULT

返回下列值之一或错误代码。

返回代码 说明
COPYENGINE_S_YES
 用户对对话框进行了响应“是”。
COPYENGINE_S_USER_RETRY
 用户已响应重试当前操作。
COPYENGINE_S_USER_IGNORED
 用户响应了对话框的“否”。
COPYENGINE_S_MERGE
 用户已响应合并文件夹。
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME
 用户已响应使用新名称重试文件。
COPYENGINE_S_DONT_PROCESS_CHILDREN
 不应处理子项。
COPYENGINE_S_PENDING
 错误已排队，稍后将显示。
COPYENGINE_E_USER_CANCELLED
 用户取消了当前操作。
COPYENGINE_E_REQUIRES_ELEVATION
 操作需要提升的权限。

要求

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