共用方式為


CVssWriter::OnBackupShutdown 方法 (vswriter.h)

OnBackupShutdown方法是由執行 BackupShutdown事件的寫入器呼叫。 當備份應用程式關閉時,它會用來執行所需的作業,特別是在備份應用程式當機時。

OnBackupShutdown 是虛擬方法。 它是由 CVssWriter 基類實作,但可由衍生類別覆寫。

語法

bool OnBackupShutdown(
  [in] VSS_ID SnapshotSetId
);

參數

[in] SnapshotSetId

備份作業中涉及陰影複製集的識別碼。

傳回值

如同基類所實作, OnBackupShutdown 一律會傳回 true

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

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

備註

CVssWriter基類的預設實作會傳回true,而不會執行任何其他作業。

如果寫入器關閉備份應用程式時要執行特殊作業,則可以覆寫預設實作。

如果未成功執行陰影複製,則陰影複製集識別碼的值 (SnapshotSetId) 為 Null

每當備份應用程式實際終止且其 IVssBackupComponents 發行時,就會產生 BackupShutdown 事件。

BackupComplete事件需要備份應用程式順利完成備份或正常失敗;如果備份應用程式是由系統終止,或是在備份 (完成之前手動終止,例如,如果備份作業無回應且必須關閉) ,則可能不是這種情況。

因此,BackupShutdown 事件比 BackupComplete 事件更強固的備份應用程式結尾訊號。

寫入器應該維護狀態資訊,以便追蹤是否已針對指定的陰影複製集傳送 BackupComplete 事件。

OnBackupShutdown的任何寫入器特定實作都應該檢查BackupComplete事件是否已處理。 它應該確保所有必要寫入器清除作業都遵循備份 (成功,否則) 會預先格式化。

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

如果此方法呼叫CVssWriterEx2::GetSessionIdCVssWriter::SetWriterFailure 或 CVssWriterEx2::SetWriterFailureEx方法,則必須在呼叫此方法的相同執行緒中執行此動作。 如需詳細資訊,請參閱 寫入器事件處理

規格需求

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

另請參閱

CVssWriter

CVssWriter::OnBackupComplete

CVssWriter::SetWriterFailure

IVssBackupComponents::BackupComplete