CVssWriterEx2：：SetWriterFailureEx 方法 (vswriter.h)

設定擴充錯誤資訊，指出寫入器在參與 VSS 作業時遇到問題。

語法

HRESULT SetWriterFailureEx(
  [in] HRESULT hrWriter,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage
);

[in] hrWriter

要傳回給要求者的錯誤碼。

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

值	意義
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 下的事件和錯誤處理。
VSS_E_WRITERERROR_PARTIAL_FAILURE	寫入器正在報告一或多個元件層級錯誤。若要報告錯誤，寫入器必須使用 IVssComponentEx2：：SetFailure 方法。

[in] hrApplication

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

[in] wszApplicationMessage

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

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

若要報告元件層級錯誤，寫入器應該使用 IVssComponentEx2：：SetFailure 方法。

如果寫入器的事件處理程式 (例如 CVssWriter：：OnFreeze) 呼叫此方法，則必須在呼叫事件處理程式的相同線程中執行此動作。如需詳細資訊，請參閱寫入器事件處理。