IVssComponent::GetRestoreMetadata-Methode (vswriter.h)

  • Artikel

Die GetRestoreMetadata-Methode ruft private, writerspezifische Wiederherstellungsmetadaten ab, die möglicherweise während eines PreRestore-Ereignisses von CVssWriter::OnPreRestore mithilfe von IVssComponent::SetRestoreMetadata festgelegt wurden.

Nur ein Writer kann diese Methode aufrufen.

Syntax

HRESULT GetRestoreMetadata(
  [out] BSTR *pbstrRestoreMetadata
);

Parameter

[out] pbstrRestoreMetadata

Eine Zeichenfolge, die die Wiederherstellungsmetadaten enthält.

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
 Das angegebene Attribut weist keinen Wert auf.
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

Diese Methode kann je nach Logik eines bestimmten Writers jederzeit aufgerufen werden.

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

Wenn keine Sicherungsmetadaten festgelegt wurden, gibt GetBackupMetadata S_FALSE zurück.

Ein Writer, der die Wiederherstellungsmethode auf VSS_RME_RESTORE_TO_ALTERNATE_LOCATION festlegt, ohne eine alternative Standortzuordnung zu definieren, stellt einen Schreibfehler dar.

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 (einschließlich Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

IVssComponent