Metode IVssComponent::GetAdditionalRestores (vswriter.h)

Metode GetAdditionalRestores digunakan oleh penulis selama operasi pemulihan bertahap atau diferensial untuk menentukan apakah komponen tertentu akan memerlukan operasi pemulihan tambahan untuk mengambilnya sepenuhnya.

Penulis atau pemohon dapat memanggil metode ini.

Sintaks

HRESULT GetAdditionalRestores(
  [out] bool *pbAdditionalRestores
);

Parameter

[out] pbAdditionalRestores

Alamat variabel yang dialokasikan penelepon yang menerima true jika pemulihan tambahan akan terjadi untuk komponen saat ini, atau salah jika sebaliknya.

Mengembalikan nilai

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai	Makna
S_OK	Berhasil mengembalikan nilai atribut.
S_FALSE	Atribut yang ditentukan tidak memiliki nilai.
E_INVALIDARG	Salah satu nilai parameter tidak valid.
E_OUTOFMEMORY	Pemanggil kehabisan memori atau sumber daya sistem lainnya.
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.

Keterangan

Nilai yang dikembalikan oleh GetAdditionalRestores akan salah, kecuali selama operasi pemulihan pemohon memanggil IVssBackupComponents::SetAdditionalRestores.

GetAdditionalRestores harus digunakan untuk memeriksa apakah perlu menggunakan lebih dari satu set cadangan untuk memulihkan komponen sepenuhnya. Komponen mungkin terlebih dahulu diambil dengan memulihkan data dari cadangan penuh, lalu memperbarui data tersebut dari satu atau beberapa cadangan inkremental atau diferensial berikutnya.

Metode GetAdditionalRestores biasanya digunakan oleh penulis yang mendukung mekanisme pemulihan eksplisit sebagai bagian dari penanganan aktivitas PostRestore mereka (CVssWriter::OnPostRestore)—misalnya, aplikasi Server Exchange, dan database seperti SQL Server. Untuk aplikasi ini, sering kali tidak mungkin untuk melakukan pemulihan diferensial, inkremental, atau log tambahan setelah pemulihan tersebut dilakukan.

Oleh karena itu, jika GetAdditionalRestores mengembalikan true untuk komponen, penulis tersebut tidak boleh menjalankan mekanisme pemulihan eksplisitnya dan harus mengharapkan bahwa pemulihan diferensial, inkremental, atau log tambahan akan dilakukan.

Ketika SetAdditionalRestores mengembalikan false, maka setelah pemulihan selesai, saat menangani peristiwa PostRestore , penulis dapat menyelesaikan operasi pemulihannya dan dibawa kembali secara online.

Persyaratan

Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	vswriter.h (termasuk Vss.h, VsWriter.h)
Pustaka	VssApi.lib

Lihat juga

IVssComponent