IVssComponent：：SetBackupStamp 方法 (vswriter.h)

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

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

語法

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 方法，讓寫入器可以使用預存的時間戳字元串。

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