IVssBackupComponents::SetPreviousBackupStamp-Methode (vsbackup.h)
Die SetPreviousBackupStamp-Methode legt den Sicherungsstempel eines früheren Sicherungsvorgangs fest, auf dem ein differenzieller oder inkrementeller Sicherungsvorgang basiert.
Die Methode kann nur während eines Sicherungsvorgangs aufgerufen werden.
Syntax
HRESULT SetPreviousBackupStamp(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] LPCWSTR wszPreviousBackupStamp
);
Parameter
[in] writerId
Writer-Bezeichner.
[in] ct
Typ der Komponente. Die möglichen Werte finden Sie unter VSS_COMPONENT_TYPE .
[in] wszLogicalPath
Breite Zeichenfolge mit Null-Endung, die den logischen Pfad der Komponente enthält.
Weitere Informationen finden Sie unter Logisches Pathing von Komponenten.
Der Wert der Zeichenfolge, die den hier verwendeten logischen Pfad enthält, sollte der gleiche sein wie beim Hinzufügen der Komponente zum Sicherungssatz mithilfe von IVssBackupComponents::AddComponent.
Der logische Pfad kann NULL sein.
[in] wszComponentName
Breite NULL-Zeichenfolge, die den Namen der Komponente enthält.
Die Zeichenfolge darf nicht NULL sein und sollte denselben Komponentennamen enthalten, der beim Hinzufügen der Komponente zum Sicherungssatz mithilfe von IVssBackupComponents::AddComponent verwendet wurde.
[in] wszPreviousBackupStamp
Der festzulegende Sicherungsstempel.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Legen Sie den vorherigen Sicherungszeitstempel erfolgreich fest. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht in der richtigen Sequenz aufgerufen. |
|
Die Sicherungskomponente ist nicht vorhanden. |
|
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet. |
Hinweise
Diese Methode sollte vor IVssBackupComponents::P repareForBackup aufgerufen werden.
Nur Anforderer können diese Methode aufrufen.
Der von SetPreviousBackupStamp festgelegte Sicherungsstempel gilt für alle Dateien in der Komponente und alle nicht auswählbaren Unterkomponenten, über die sie verfügt.
Anforderer speichern die Sicherungsstempel lediglich im Dokument Sicherungskomponenten. Sie können die Sicherungsstempel nicht direkt verwenden, kennen ihr Format nicht und wissen nicht, wie sie generiert werden sollen.
Daher sollte der mit SetPreviousBackupStamp festgelegte Wert entweder aus dem gespeicherten Dokument der Sicherungskomponenten eines früheren Sicherungsvorgangs (mit IVssComponent::GetBackupStamp für die richtige Komponente) oder aus den vom Anforderer gespeicherten Informationen in seinen eigenen internen Datensätzen abgerufen werden.
Ein Writer ruft dann diesen Wert ab (mithilfe von IVssComponent::GetPreviousBackupStamp) und kann die entsprechenden Dateien für die Teilnahme an einer inkrementellen oder differenziellen Sicherung markieren.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |