CVssWriter：：OnFreeze 方法 (vswriter.h)

發行項
03/09/2024

OnFreeze 方法是由在陰影複製凍結開始時收到 Freeze 事件的寫入器呼叫。寫入器會使用這個方法來執行參與凍結或凍結所需的作業。

OnFreeze 是純虛擬方法。它不是由 CVssWriter 基類實作，而且必須由衍生類別實作。

Syntax

bool OnFreeze();

傳回值

此方法的實作必須傳回 true ，但發生嚴重錯誤的情況除外。如果發生嚴重錯誤，方法必須呼叫 CVssWriter：：SetWriterFailure 方法，才能提供失敗的描述，然後再傳回 false。如果發生非嚴重錯誤，方法仍應呼叫 SetWriterFailure ，但傳回 true。如果錯誤是由暫時性問題所造成，方法應該在 對 SetWriterFailure 的呼叫中指定VSS_E_WRITERERROR_RETRYABLE。

在發生失敗的所有情況下，方法應該將事件寫入事件記錄檔，以報告失敗的確切原因。

備註

在此方法中，寫入器應用程式應該將本身放入與 VSS 作業相容的妥善定義狀態。

在此方法中，寫入器應該完成最終準備，以支援建立陰影複製。建立陰影複製之後，寫入器將會收到 Thaw 事件，並可繼續正常作業。

根據預設，凍結和解除凍結事件之間的逾時時間範圍是 60 秒。也就是說，如果未收到逾時時段的 Thaw 事件，就會產生 Abort 事件。寫入器可以將 dwTimeoutFreeze 自變數設定為 CVssWriter：：Initialize，在初始化時間變更逾時視窗。

寫入器如何準備陰影複製，與裝載陰影複製的應用程式高度相依。有些應用程式可以承受保留所有寫入，並讓數據在此期間保持絕對一致狀態。其他應用程式，例如許多資料庫無法在此期間停止工作，但可以採取動作，例如檢查點檢查其狀態，這可能會降低在此時段期間所建立陰影複製的復原時間。

如果寫入器無法將自己放入凍結的妥善定義狀態，就會發生下列情況：

OnFreeze 應該會 傳回 false，並確認陰影複製。
寫入器會呼叫 CVssWriter：：SetWriterFailure 來提供失敗的描述。
中止事件會在 OnFreeze 傳回 false 時產生

寫入器永遠不會從這個方法或任何其他 CVssWriter (Ex) ：：OnXxx 回呼方法擲回例外狀況。

處理 Freeze 事件的逾時時間範圍通常與處理 PrepareForSnapshot 事件的逾時時間範圍相較之下。因此，開發人員應該避免此方法中的冗長作業。一般用途可能是暫停寫入器記錄。

建議 CVssWriter：：OnPrepareSnapshot 處理所有耗時的作業。

在此方法之後，將會呼叫 CVssWriter：：OnThaw 或 CVssWriter：：OnAbort 。

如果此方法呼叫 CVssWriterEx2：：GetSessionId、CVssWriter：：SetWriterFailure 或 CVssWriterEx2 ：：SetWriterFailureEx 方法，則必須在呼叫此方法的相同線程中執行此動作。如需詳細資訊，請參閱寫入器事件處理。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	vswriter.h (包括 Vss.h、VsWriter.h)
程式庫	VssApi.lib