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。

傳回碼	Description
COPYENGINE_S_USERRETRY	處理常式應該重試檔案作業。
COPYENGINE_S_USERRETRYWITHNEWNAME	處理常式應該使用 pszRename 緩衝區中傳回的名稱重試檔案作業。
COPYENGINE_S_OVERWRITE	使用者已指出處理常式應該覆寫現有的檔案。
COPYENGINE_S_RETRYWITHOUTSECURITY	使用者已指出處理常式應該在不使用安全描述項的情況下，再次嘗試作業。
COPYENGINE_E_USERCANCELLED	使用者已按一下 [ 取消]。正在終止整個複製作業。處理常式應該會將此程式碼傳回至複製引擎。