CVssWriter::OnPostRestore 方法 (vswriter.h)
OnPostRestore 方法是由 PostRestore 事件後面的寫入器呼叫。 它會用來執行要求者還原至磁碟之後,所考慮的作業。 不過,這些作業無法修改備份元件檔。
OnPostRestore 是虛擬方法。 它是由 CVssWriter 基類實作,但可由衍生類別覆寫。
語法
bool OnPostRestore(
[in] IVssWriterComponents *pComponent
);
參數
[in] pComponent
VSS 所傳入 之 IVssWriterComponents 物件的指標,以提供方法對寫入器元件資訊的存取權。 如果要求者不支援 CVssWriter::AreComponentsSelected 傳回 false () ,則此參數的值可能是 NULL。
傳回值
如同基類所實作, OnPostRestore 一律會傳回 true。
此方法的任何其他實作都必須傳回 true ,但發生嚴重錯誤的情況除外。 如果發生嚴重錯誤,方法必須呼叫 CVssWriter::SetWriterFailure 方法,才能提供失敗的描述,然後再傳回 false。 如果發生非嚴重錯誤,方法仍應呼叫 SetWriterFailure ,但傳回 true。 如果錯誤是由暫時性問題所造成,方法應該在 對 SetWriterFailure 的呼叫中指定VSS_E_WRITERERROR_RETRYABLE。
在發生失敗的所有情況下,方法應該將事件寫入事件記錄檔,以報告失敗的確切原因。
備註
CVssWriter 基類的預設實作會傳回 true,而不會執行任何其他作業。
如有必要,寫入器應該移除任何暫存盤,並釋放其參與還原所需的任何系統資源。
寫入器永遠不會從這個方法或任何其他 CVssWriter (Ex) ::OnXxx 回呼方法擲回例外狀況。
隨著 PostRestore 事件的產生,要求者的備份元件檔會變成唯讀檔。 因此,嘗試透過介面修改檔 (,例如,呼叫 IVssComponent::SetRestoreMetadata) 會在 OnPostRestore 的用戶實作中失敗。
如果此方法呼叫 CVssWriterEx2::GetSessionId、CVssWriter::SetWriterFailure 或 CVssWriterEx2::SetWriterFailureEx 方法,則必須在呼叫此方法的相同線程中執行此動作。 如需詳細資訊,請參閱 寫入器事件處理。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | vswriter.h (包括 Vss.h、VsWriter.h) |
程式庫 | VssApi.lib |