IVssComponent::GetBackupStamp-Methode (vswriter.h)

Die GetBackupStamp-Methode gibt die Sicherungsstempelzeichenfolge zurück, die von einem Writer für eine bestimmte Komponente gespeichert ist.

Entweder ein Writer oder ein Anforderer kann diese Methode aufrufen.

Syntax

HRESULT GetBackupStamp(
  [out] BSTR *pbstrBackupStamp
);

Parameter

[out] pbstrBackupStamp

Die Adresse einer vom Aufrufer zugeordneten Variablen, die eine Zeichenfolge mit dem Sicherungsstempel empfängt, der den Zeitpunkt angibt, zu dem die Komponente gesichert wurde.

Rückgabewert

Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.

Wert Bedeutung
S_OK
Der Attributwert wurde erfolgreich zurückgegeben.
S_FALSE
Dieser Komponente ist kein Zeitstempel zugeordnet.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt über nicht genügend 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

Wenn kein Sicherungszeitstempel festgelegt wurde, gibt GetBackupStamp S_FALSE zurück.

Wenn der Aufruf von GetBackupStamp erfolgreich ist, ist der Aufrufer dafür verantwortlich, die im pbstrBackupStamp-Parameter zurückgegebene Zeichenfolge durch Aufrufen der SysFreeString-Funktion freizugeben.

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 GetBackupStamp abgerufene Sicherungsstempel wird im Allgemeinen von einem Writer durch einen Aufruf von IVssComponent::SetBackupStamp aus dem PostSnapshot-EreignishandlerCVssWriter::OnPostSnapshot festgelegt.

Die Anforderer speichern die Sicherungsstempel lediglich im Dokument "Sicherungskomponenten". sie verwenden den Sicherungsstempel nicht direkt, wissen nicht, wie er generiert wird, oder verstehen sein Format.

Anforderungen

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

Weitere Informationen

IVssBackupComponents::SetPreviousBackupStamp

IVssComponent

IVssComponent::SetBackupStamp