IVssComponent::SetBackupStamp-Methode (vswriter.h)

Die SetBackupStamp-Methode legt eine Zeichenfolge fest, die Informationen enthält, die angeben, wann eine Sicherung durchgeführt wurde.

Ein Writer kann diese Methode nur während eines Sicherungsvorgangs aufrufen.

Diese Methode kann nicht aufgerufen werden, wenn ein BackupComplete-Ereignis (CVssWriter::OnBackupComplete) oder BackupShutdown (CVssWriter::OnBackupShutdown) behandelt wird.

Syntax

HRESULT SetBackupStamp(
  [in] LPCWSTR wszBackupStamp
);

Parameter

[in] wszBackupStamp

Informationen zur breiten Zeichenfolge mit Null-Beendigung, die angibt, wann eine Sicherung durchgeführt wurde.

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Wert Bedeutung
S_OK
Legen Sie den Sicherungszeitstempel erfolgreich fest.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE
Diese Methode wurde nicht von einem Writer aufgerufen oder, wenn sie von einem Writer aufgerufen wurde, entweder während eines Sicherungsvorgangs nicht aufgerufen oder beim Behandeln eines BackupComplete- oder BackupShutdown-Ereignisses aufgerufen.

Hinweise

Weitere Informationen zu Sicherungsstempeln finden Sie unter Writer Role in Backup Up Complex Stores.

Der von SetBackupStamp festgelegte Sicherungsstempel gilt für alle Dateien in der Komponente und alle nicht auswählbaren Unterkomponenten, die sie besitzt.

Writer rufen in der Regel SetBackupStamp auf, während sie ein PostSnapshot-Ereignis in CVssWriter::OnPostSnapshot behandeln.

Die Anforderer speichern den Sicherungsstempel lediglich im Dokument "Sicherungskomponenten". Sie verwenden den Sicherungsstempel nicht direkt oder müssen ihn interpretieren können.

Die einzige Verwendung des Sicherungsstempels, den ein Anforderer während eines Wiederherstellungsvorgangs angibt, besteht darin, die gespeicherte Zeitstempelzeichenfolge mithilfe der IVssBackupComponents::SetPreviousBackupStamp-Methode für einen Writer verfügbar zu machen.

Aus diesem Grund gibt es keine Formateinschränkungen für den Inhalt des Sicherungsstempels. Es kann Zeit- und Datumsinformationen, logische Sequenznummern oder andere Informationen enthalten, mit denen ein Writer derselben Klasse bestimmen kann, wann die letzte Sicherung durchgeführt wurde.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vswriter.h (einschließlich Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

IVssComponent

IVssComponent::GetBackupStamp