ITransferAdviseSink：：SubStreamFailure 方法 (shobjidl_core.h)

当发生涉及辅助流且需要用户交互的故障时调用。

语法

HRESULT SubStreamFailure(
  [in] IShellItem *psi,
  [in] LPCWSTR    pszStreamName,
  [in] HRESULT    hrError
);

[in] psi

类型： IShellItem*

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

[in] pszStreamName

类型： LPCWSTR

将在操作中丢失的数据的名称。

[in] hrError

类型： HRESULT

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

类型： HRESULT

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

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