IVssComponentEx2：：SetFailure 方法 (vswriter.h)

VSS 寫入器會呼叫這個方法，以報告元件層級的錯誤。

語法

HRESULT SetFailure(
  [in] HRESULT hr,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage,
  [in] DWORD   dwReserved
);

[in] hr

要傳回給呼叫 IVssComponentEx2：：GetFailure 方法之要求者的錯誤碼。

以下是這個方法可以設定的錯誤碼。

值	意義
S_OK	寫入器成功。
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT	陰影複製只包含寫入器所需的磁片區子集，以正確備份應用程式元件。
VSS_E_WRITERERROR_OUTOFRESOURCES	寫入器記憶體不足或其他系統資源。處理此錯誤碼的建議方法是等候 10 分鐘，然後重複作業，最多三次。
VSS_E_WRITERERROR_TIMEOUT	寫入器作業因為凍結和解除凍結事件之間的逾時而失敗。處理此錯誤碼的建議方法是等候 10 分鐘，然後重複作業，最多三次。
VSS_E_WRITERERROR_RETRYABLE	寫入器因為重新開機整個備份、還原或陰影複製建立程式時可能發生的錯誤而失敗。處理此錯誤碼的建議方法是等候 10 分鐘，然後重複作業，最多三次。
VSS_E_WRITERERROR_NONRETRYABLE	寫入器作業失敗，因為建立另一個陰影複製時可能會遞迴的錯誤。如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。

[in] hrApplication

要傳回給要求者的其他錯誤碼。這是選擇性參數。

[in] wszApplicationMessage

字串，包含要求者要向使用者顯示的錯誤訊息。寫入器會在必要時負責當地語系化此字串，再于此方法中使用。此參數是選擇性的，可以是 Null 或空字串。

[in] dwReserved

此參數保留供日後使用，且應設定為零。

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

除了呼叫這個方法之外，請使用 CVssWriterEx2：：SetWriterFailureEx 方法來報告發生部分寫入器失敗。