IVssBackupComponents::InitializeForBackup-Methode (vsbackup.h)
Die InitializeForBackup-Methode initialisiert die Metadaten der Sicherungskomponenten zur Vorbereitung der Sicherung.
Syntax
HRESULT InitializeForBackup(
[in] BSTR bstrXML
);
Parameter
[in] bstrXML
Optional. Bei Importen von transportierten Schattenkopien muss dieser Parameter das Originaldokument sein, das beim Erstellen der gespeicherten Schattenkopie generiert und mit IVssBackupComponents::SaveAsXML gespeichert wurde.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Das angegebene Dokument für die Sicherung wurde erfolgreich initialisiert. |
|
Der Aufrufer verfügt nicht über ausreichende Sicherungsberechtigungen oder ist kein Administrator. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das Sicherungskomponentenobjekt wird nicht initialisiert, diese Methode wurde während eines Wiederherstellungsvorgangs aufgerufen, oder diese Methode wurde nicht innerhalb der richtigen Sequenz aufgerufen. |
|
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
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.
Weitere Informationen zur Verwendung von InitializeForBackup mit transportierbaren Schattenkopien finden Sie unter Importieren von transportablen schattenkopierten Volumes.
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 (enthalten VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |