IVssComponentEx2：：GetFailure 方法 (vswriter.h)

VSS 要求者會呼叫此方法，以擷取寫入器所報告的元件層級錯誤。

語法

HRESULT GetFailure(
  [out] HRESULT *phr,
  [out] HRESULT *phrApplication,
  [out] BSTR    *pbstrApplicationMessage,
  [out] DWORD   *pdwReserved
);

[out] phr

呼叫端配置的變數位址，接收寫入器針對 IVssComponentEx2：：SetFailure 方法之 hr 參數傳遞的 HRESULT 失敗碼。這個參數是必要的，而且不能是 NULL。

以下是支援的值。

值	意義
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_WRITER_NOT_RESPONDING	寫入器沒有回應。
VSS_E_WRITER_STATUS_NOT_AVAILABLE	寫入器狀態不適用於一或多個寫入器。寫入器可能已達到可用備份和還原會話的數目上限。

[out] phrApplication

呼叫端配置的變數位址，接收寫入器針對 SetFailure 方法之 hrApplication 參數傳遞的傳回碼。這個參數是必要的，而且不能是 NULL。

[out] pbstrApplicationMessage

呼叫端配置的變數位址，該變數會接收寫入器針對SetFailure方法之 wszApplicationMessage 參數傳遞的應用程式失敗訊息。這個參數是必要的，而且不能是 NULL。

[out] pdwReserved

呼叫端配置的 DWORD 變數位址。此參數保留供日後使用，但必要且不可為 NULL。

以下是這個方法的有效傳回碼。

值	意義
S_OK 0x00000000L	已成功傳回指定寫入器的狀態。請注意，必須檢查 phrFailureWriter 參數的值，以確認寫入器是否成功。寫入器失敗碼可以是 VsWriter.h 和寫入器錯誤和 Vetoes 中列出的錯誤。
E_INVALIDARG 0x80070057L	phr、phrApplication、pbstrApplicationMessage 或 pdwReserved 參數為 NULL。
E_OUTOFMEMORY 0x8007000EL	呼叫端記憶體不足或其他系統資源。
VSS_E_BAD_STATE 0x80042301L	備份元件物件未初始化、在還原作業期間呼叫此方法，或未在正確的順序內呼叫此方法。

當呼叫端完成存取此方法傳回的狀態資訊時，它應該呼叫 SysFreeString 以釋放 pbstrApplicationMessage 參數所持有的記憶體。