ITransferAdviseSink：:P ropertyFailure 方法 (shobjidl_core.h)

当存在涉及文件属性且需要用户交互的故障时调用。

语法

HRESULT PropertyFailure(
  [in] IShellItem        *psi,
  [in] const PROPERTYKEY *pkey,
  [in] HRESULT           hrError
);

[in] psi

类型： IShellItem*

指向导致失败的 IShellItem 的指针。

[in] pkey

类型： const PROPERTYKEY*

一个值，该值对应于将丢失的属性。 NULL 值表示所有属性都已丢失。

[in] hrError

类型： HRESULT

失败生成的错误代码。它必须由复制引擎处理。

类型： HRESULT

应传递任何其他 HRESULT 。如果未处理失败，则返回值应为 hrError。

返回代码	说明
COPYENGINE_S_USERRETRY	处理程序应重试文件操作。
COPYENGINE_S_USERRETRYWITHNEWNAME	处理程序应使用 pszRename 缓冲区中返回的名称重试文件操作。
COPYENGINE_S_OVERWRITE	用户已指示处理程序应覆盖现有文件。
COPYENGINE_S_RETRYWITHOUTSECURITY	用户已指示处理程序应在不使用安全描述符的情况下重试该操作。
COPYENGINE_E_USERCANCELLED	用户单击了 “取消”。正在终止整个复制作业。处理程序应将此代码返回给复制引擎。