IVssBackupComponents::InitializeForRestore-Methode (vsbackup.h)

Die InitializeForRestore-Methode initialisiert die IVssBackupComponents-Schnittstelle zur Vorbereitung eines Wiederherstellungsvorgangs.

Syntax

HRESULT InitializeForRestore(
  [in] BSTR bstrXML
);

Parameter

[in] bstrXML

XML-Zeichenfolge mit dem Dokument "Sicherungskomponenten", das von einem Sicherungsvorgang generiert und von IVssBackupComponents::SaveAsXML gespeichert wurde.

Rückgabewert

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

Wert Bedeutung
S_OK
Das angegebene Dokument wurde erfolgreich für die Sicherung initialisiert.
E_ACCESSDENIED
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator.
E_OUTOFMEMORY
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_BAD_STATE
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht in der richtigen Sequenz aufgerufen.
VSS_E_INVALID_XML_DOCUMENT
Fehler beim Laden des angegebenen XML-Dokuments.
VSS_E_UNEXPECTED
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

Das für diese Methode bereitgestellte XML-Dokument initialisiert das IVssBackupComponents-Objekt mit Metadaten, die zuvor durch einen Aufruf von IVssBackupComponents::SaveAsXML gespeichert wurden. Benutzer sollten dieses Metadatendokument nicht manipulieren.

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

Weitere Informationen

IVssBackupComponents

IVssBackupComponents::InitializeForBackup

IVssBackupComponents::SaveAsXML