Metode IVssBackupComponents::SaveAsXML (vsbackup.h)

  • Artikel

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
S_OK
 Berhasil menyimpan dokumen XML sebagai nilai parameter pbstrXML .
E_INVALIDARG
 Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY
 Pemanggil kehabisan memori atau sumber daya sistem lainnya.
VSS_E_BAD_STATE
 Objek komponen cadangan tidak diinisialisasi, metode ini telah dipanggil selama operasi pemulihan, atau metode ini belum dipanggil dalam urutan yang benar.
VSS_E_UNEXPECTED
 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

IVssBackupComponents::GatherWriterMetadata

IVssBackupComponents::InitializeForBackup

IVssBackupComponents::InitializeForRestore

IVssBackupComponents::P repareForBackup