共用方式為


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
phrphrApplicationpbstrApplicationMessagepdwReserved 參數為 NULL
E_OUTOFMEMORY
0x8007000EL
呼叫端記憶體不足或其他系統資源。
VSS_E_BAD_STATE
0x80042301L
備份元件物件未初始化、在還原作業期間呼叫此方法,或未在正確的順序內呼叫此方法。

備註

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

規格需求

需求
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 vswriter.h

另請參閱

IVssComponentEx2