共用方式為


IVssComponent::SetBackupStamp 方法 (vswriter.h)

SetBackupStamp 方法會設定字串,其中包含指出備份何時發生時的資訊。

寫入器只能在備份作業期間呼叫此方法。

處理 CVssWriter::OnBackupComplete () 或 BackupShutdown (CVssWriter::OnBackupShutdown) 事件時,無法呼叫此方法。

語法

HRESULT SetBackupStamp(
  [in] LPCWSTR wszBackupStamp
);

參數

[in] wszBackupStamp

以 Null 終止的寬字元字串資訊,指出備份何時發生。

傳回值

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

意義
S_OK
成功設定備份時間戳。
E_INVALIDARG
其中一個參數值無效。
E_OUTOFMEMORY
呼叫端記憶體不足或其他系統資源。
VSS_E_BAD_STATE
這個方法不是由寫入器呼叫,或者,如果寫入器呼叫,在備份作業期間或是在處理BackupComplete或BackupShutdown事件時呼叫此方法。

備註

如需備份戳記的詳細資訊,請參閱 備份複雜存放區中的寫入器角色

SetBackupStamp 所設定的備份戳記會套用至元件中的所有檔案,以及它擁有的任何不可選取的子元件。

寫入器通常會在 CVssWriter::OnPostSnapshot 中處理 PostSnapshot 事件時呼叫 SetBackupStamp

要求者只會將備份戳記儲存在備份元件檔中。 它們不會直接使用備份戳記,或必須知道如何解譯它。

要求者在還原作業期間唯一使用的備份戳記,就是使用 IVssBackupComponents::SetPreviousBackupStamp 方法,讓寫入器可以使用預存的時間戳字元串。

基於這個理由,備份戳記的內容沒有格式限制。 它可能包含時間和日期資訊、邏輯序號或任何其他資訊,以允許相同類別的寫入器判斷上次備份何時發生。

規格需求

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

另請參閱

IVssComponent

IVssComponent::GetBackupStamp