Metode IVssBackupComponents::InitializeForRestore (vsbackup.h)

  • Artikel

Metode InitializeForRestore menginisialisasi antarmuka IVssBackupComponents sebagai persiapan untuk operasi pemulihan.

Sintaks

HRESULT InitializeForRestore(
  [in] BSTR bstrXML
);

Parameter

[in] bstrXML

String XML yang berisi Dokumen Komponen Cadangan yang dihasilkan oleh operasi pencadangan dan disimpan oleh IVssBackupComponents::SaveAsXML.

Nilai kembali

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 istimewa 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
 Operasi pemuatan dokumen XML yang ditentukan gagal.
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.

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::InitializeForBackup

IVssBackupComponents::SaveAsXML