ITransferAdviseSink：：FileFailure 方法 (shobjidl_core.h)

發生失敗且需要用戶互動時呼叫。

語法

HRESULT FileFailure(
  [in]      IShellItem *psi,
  [in]      LPCWSTR    pszItem,
  [in]      HRESULT    hrError,
  [in, out] LPWSTR     pszRename,
  [in]      ULONG      cchRename
);

參數

[in] psi

類型： IShellItem*

作業失敗的 IShellItem 。

[in] pszItem

類型： LPCWSTR

選擇性。 包含檔名之 Null 終止緩衝區的指標。 如果此值為 NULL，則會使用 psi 參數所提供的名稱。

[in] hrError

類型： HRESULT

失敗所產生的錯誤碼。 這個錯誤必須由複製引擎處理。

[in, out] pszRename

類型： LPWSTR

選擇性。 當這個方法傳回時，會包含 Null 終止緩衝區的指標，其中包含檔案的新名稱。 名稱不能超過長度 cchRename。 如果此參數為 NULL，則無法使用重新命名的選項。

[in] cchRename

類型： ULONG

pszRename 緩衝區的大小，以字元為單位。

傳回值

類型： HRESULT

任何其他 HRESULT 都應該傳回給呼叫進程。 如果未處理失敗，傳回值應該是 hrError。

傳回碼	Description
COPYENGINE_S_USER_RETRY	用戶按兩下 [ 重試]。 處理程式應該重試檔案作業。
COPYENGINE_E_USERCANCELLED	用戶按兩下 [ 取消]。 正在終止整個複製作業。 處理程式應該會將此程式代碼傳回至複製引擎。
COPYENGINE_S_USER_IGNORED	用戶按兩下 [ 忽略]。 處理程式應該略過建立專案，並將此程式碼傳回至複製引擎。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包括 Shobjidl.h)