Metode IVssBackupComponents::SaveAsXML (vsbackup.h)
Metode SaveAsXML menyimpan Dokumen Komponen Cadangan yang berisi informasi status pemohon ke string tertentu. Dokumen XML ini, yang berisi Dokumen Komponen Cadangan, harus selalu disimpan dengan aman sebagai bagian dari operasi pencadangan.
Sintaks
HRESULT SaveAsXML(
[in] BSTR *pbstrXML
);
Parameter
[in] pbstrXML
Penunjuk ke string yang akan digunakan untuk menyimpan Dokumen Komponen Cadangan yang berisi informasi status pemohon.
Mengembalikan nilai
Berikut ini adalah kode pengembalian yang valid untuk metode ini.
| Nilai | Makna |
|---|---|
|
Berhasil menyimpan dokumen XML sebagai nilai parameter pbstrXML . |
|
Salah satu nilai parameter tidak valid. |
|
Pemanggil kehabisan memori atau sumber daya sistem lainnya. |
|
Objek komponen cadangan tidak diinisialisasi, metode ini telah dipanggil selama operasi pemulihan, atau metode ini belum dipanggil dalam urutan yang benar. |
|
Kesalahan tak terduga. Kode kesalahan dicatat dalam file log kesalahan. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Nilai ini tidak didukung sampai Windows Server 2008 R2 dan Windows 7. E_UNEXPECTED digunakan sebagai gantinya. |
Keterangan
Untuk operasi pencadangan umum, SaveAsXML tidak boleh dipanggil sampai setelah penulis dan pemohon selesai memodifikasi Dokumen Komponen Cadangan.
Penulis dapat terus memodifikasi Dokumen Komponen Cadangan hingga berhasil kembali dari menangani peristiwa PostSnapshot (CVssWriter::OnPostSnapshot), atau setara setelah penyelesaian IVssBackupComponents::D oSnapshotSet.
Pemohon harus terus mengubah Dokumen Komponen Cadangan saat pencadangan berlangsung. Secara khusus, pemohon akan menyimpan catatan komponen demi komponen dari keberhasilan atau kegagalan pencadangan melalui panggilan ke metode IVssBackupComponents::SetBackupSucceeded .
Setelah pemohon selesai memodifikasi Dokumen Komponen Cadangan, pemohon harus menggunakan SaveAsXML untuk menyimpan salinan dokumen ke media cadangan.
Dokumen Komponen Cadangan dapat disimpan di titik-titik sebelumnya dalam siklus hidup operasi pencadangan—misalnya, untuk mendukung pembuatan salinan bayangan yang dapat diangkut untuk ditangani pada komputer jarak jauh. (Lihat Mengimpor Volume Salinan Bayangan yang Dapat Diangkut untuk informasi selengkapnya.)
Namun, SaveAsXML tidak boleh dipanggil sebelum IVssBackupComponents::P repareForBackup, karena Dokumen Komponen Cadangan tidak akan diisi oleh pemohon dan penulis.
Persyaratan
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | vsbackup.h (termasuk VsBackup.h, Vss.h, VsWriter.h) |
| Pustaka | VssApi.lib |
Lihat juga
IVssBackupComponents::GatherWriterMetadata
IVssBackupComponents::InitializeForBackup