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 |
---|---|
|
Der Attributwert wurde erfolgreich zurückgegeben. |
|
Dieser Komponente ist kein Zeitstempel zugeordnet. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
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 |