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。

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