IVssBackupComponents::SaveAsXML-Methode (vsbackup.h)
Die SaveAsXML-Methode speichert das Sicherungskomponentendokument, das die Statusinformationen eines Anforderers enthält, in einer angegebenen Zeichenfolge. Dieses XML-Dokument, das das Dokument Sicherungskomponenten enthält, sollte immer sicher als Teil eines Sicherungsvorgangs gespeichert werden.
Syntax
HRESULT SaveAsXML(
[in] BSTR *pbstrXML
);
Parameter
[in] pbstrXML
Zeiger auf eine Zeichenfolge, die zum Speichern des Sicherungskomponentendokuments verwendet werden soll, das die Statusinformationen eines Anforderers enthält.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Das XML-Dokument wurde erfolgreich als pbstrXML-Parameterwert gespeichert. |
|
Einer der Parameterwerte ist ungültig. |
|
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. |
|
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
Für einen typischen Sicherungsvorgang sollte SaveAsXML erst aufgerufen werden, nachdem sowohl Writer als auch der Anforderer das Dokument "Sicherungskomponenten" geändert haben.
Writer können das Dokument "Sicherungskomponenten" so lange ändern, bis sie erfolgreich von der Behandlung des PostSnapshot-Ereignisses (CVssWriter::OnPostSnapshot) oder gleichwertig nach Abschluss von IVssBackupComponents::D oSnapshotSet zurückgegeben werden.
Die Anforderer müssen das Sicherungskomponentendokument weiterhin ändern, während die Sicherung fortgesetzt wird. Insbesondere speichert ein Anforderer über Aufrufe der IVssBackupComponents::SetBackupSucceeded-Methode einen Komponenten-für-Komponentendatensatz über den Erfolg oder Fehler der Sicherung.
Nachdem der Anforderer die Änderung des Sicherungskomponentendokuments abgeschlossen hat, sollte der Anforderer SaveAsXML verwenden, um eine Kopie des Dokuments auf dem Sicherungsmedium zu speichern.
Ein Sicherungskomponentendokument kann zu früheren Zeitpunkten im Lebenszyklus eines Sicherungsvorgangs gespeichert werden– für instance, um die Generierung von transportierbaren Schattenkopien zu unterstützen, die auf Remotecomputern verarbeitet werden sollen. (Weitere Informationen finden Sie unter Importieren von transportablen schattenkopierten Volumes .)
SaveAsXML sollte jedoch nie vor IVssBackupComponents::P repareForBackup aufgerufen werden, da das Dokument sicherungskomponenten nicht vom Anforderer und den Writern ausgefüllt wurde.
Anforderungen
| 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 |
Weitere Informationen
IVssBackupComponents::GatherWriterMetadata
IVssBackupComponents::InitializeForBackup