Bagikan melalui

Metode IVssBackupComponents::InitializeForBackup (vsbackup.h)

  • Artikel

Metode InitializeForBackup menginisialisasi metadata komponen cadangan sebagai persiapan untuk pencadangan.

Sintaks

HRESULT InitializeForBackup(
  [in] BSTR bstrXML
);

Parameter

[in] bstrXML

Pilihan. Selama impor salinan bayangan yang diangkut, parameter ini harus menjadi dokumen asli yang dihasilkan saat membuat salinan bayangan yang disimpan dan disimpan menggunakan IVssBackupComponents::SaveAsXML.

Mengembalikan nilai

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai Makna
S_OK
 Berhasil menginisialisasi dokumen yang ditentukan untuk pencadangan.
E_ACCESSDENIED
 Pemanggil tidak memiliki hak pencadangan yang memadai atau bukan administrator.
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_INVALID_XML_DOCUMENT
 Dokumen XML tidak valid. Periksa log peristiwa untuk detailnya. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.
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

Dokumen XML yang disediakan untuk metode ini menginisialisasi objek IVssBackupComponents dengan metadata yang sebelumnya disimpan oleh panggilan ke IVssBackupComponents::SaveAsXML. Pengguna tidak boleh mengubah dokumen metadata ini.

Untuk informasi selengkapnya tentang cara menggunakan InitializeForBackup dengan salinan bayangan yang dapat diangkut, lihat Mengimpor Volume Salinan Bayangan yang Dapat Diangkut.

Persyaratan

Persyaratan Nilai
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::SaveAsXML