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 |
|---|---|
|
Legen Sie den Sicherungszeitstempel erfolgreich fest. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
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 |