IVssComponent::GetPreviousBackupStamp-Methode (vswriter.h)

Die GetPreviousBackupStamp-Methode gibt einen vorherigen Sicherungsstempel zurück, der von einem Anforderer im Dokument Sicherungskomponenten geladen wurde. Der Wert wird von einem Writer verwendet, wenn er entscheidet, ob Dateien am differenziellen oder inkrementellen Sicherungsvorgang teilnehmen sollen.

Entweder ein Writer oder ein Anforderer kann diese Methode aufrufen.

Syntax

HRESULT GetPreviousBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

Parameter

[out] pbstrBackupStamp

Zeiger auf eine Zeichenfolge, die den Zeitstempel einer vorherigen Sicherung enthält, damit eine differenzielle oder inkrementelle Sicherung ordnungsgemäß implementiert werden kann.

Rückgabewert

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

Wert Bedeutung
S_OK
Der Attributwert wurde erfolgreich zurückgegeben.
S_FALSE
Es wurde kein vorheriger Sicherungszeitstempel festgelegt.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_INVALID_XML_DOCUMENT
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.

Hinweise

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

Der Aufrufer sollte den Arbeitsspeicher des pbstrBackupStamp-Parameters durch Aufrufen von SysFreeString freigeben.

Wenn kein vorheriger Sicherungszeitstempel vorhanden ist, gibt GetPreviousBackupStamp S_FALSE zurück.

Die zurückgegebene Zeichenfolge bezieht sich auf alle Dateien in der Komponente und alle nicht auswählbaren Unterkomponenten, über die sie verfügt.

Der von GetPreviousBackupStamp abgerufene Sicherungsstempel wird von einem Anforderer mithilfe von IVssBackupComponents::SetPreviousBackupStamp festgelegt.

In der Regel wurde die Zeichenfolge, die zum Festlegen des von GetPreviousBackupStamp gefundenen Werts verwendet wird, aus einem gespeicherten Dokument der Sicherungskomponenten abgerufen oder vom Anfordernden als Teil seiner eigenen internen Datensätze gespeichert.

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

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent