IFileOperationProgressSink::P reRenameItem 方法 (shobjidl_core.h)

在每个项的重命名过程开始之前,执行调用方实现的操作。

语法

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

参数

[in] dwFlags

类型:DWORD

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

[in] psiItem

类型: IShellItem*

指向指定要重命名的项的 IShellItem 的指针。

[in] pszNewName

类型: LPCWSTR

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

返回值

类型: HRESULT

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

要求

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