Metode IVssBackupComponents::BackupComplete (vsbackup.h)

Artikel
03/08/2023

Metode BackupComplete menyebabkan VSS menghasilkan peristiwa BackupComplete , yang memberi sinyal kepada penulis bahwa proses pencadangan telah selesai.

Sintaks

HRESULT BackupComplete(
  [out] IVssAsync **ppAsync
);

Parameter

[out] ppAsync

Dua kali penunjuk tidak langsung ke instans IVssAsync .

Mengembalikan nilai

Berikut ini adalah kode pengembalian yang valid untuk metode ini.

Nilai	Makna
S_OK	Berhasil mengembalikan pointer ke instans antarmuka IVssAsync . Lihat IVssAsync::QueryStatus untuk nilai valid yang dikembalikan oleh parameter pHrResult .
E_INVALIDARG	ppAsync tidak menunjuk ke penunjuk yang valid; yaitu, null.
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.
VSS_E_UNEXPECTED_WRITER_ERROR	Terjadi kesalahan tak terduga selama komunikasi dengan penulis. Kode kesalahan dicatat dalam file log kesalahan. Untuk informasi selengkapnya, lihat Penanganan Peristiwa dan Kesalahan di bawah VSS.

Keterangan

Saat bekerja dalam mode komponen (IVssBackupComponents::SetBackupState dipanggil dengan argumen komponen tertentu DARI TRUE), penulis dapat menentukan keberhasilan atau kegagalan pencadangan komponen apa pun yang secara eksplisit disertakan dalam komponen Dokumen Komponen Cadangan dengan menggunakan IVssComponent::GetBackupSucceeded. Oleh karena itu, aplikasi cadangan yang berperilaku baik (pemohon) harus memanggil IVssBackupComponents::SetBackupSucceeded setelah setiap komponen diproses dan sebelum memanggil BackupComplete.

Jangan panggil metode ini jika panggilan ke IVssBackupComponents::D oSnapshotSet gagal. Untuk informasi selengkapnya tentang cara pemohon menggunakan DoSnapshotSet, SetBackupSucceeded, dan BackupComplete dalam operasi pencadangan, lihat Gambaran Umum Tugas Pra-Pencadangan dan Gambaran Umum Pencadangan File Aktual.

Operasi ini asinkron. Pemanggil dapat menggunakan metode antarmuka QueryStatus di antarmuka IVssAsync yang dikembalikan untuk menentukan status pemberitahuan.

Setelah memanggil BackupComplete, pemohon harus memanggil GatherWriterStatus untuk menyebabkan sesi penulis diatur ke status selesai.

Catatan Ini hanya diperlukan pada Windows Server 2008 dengan Paket Layanan 2 (SP2) dan yang lebih lama.

Aplikasi cadangan dapat memilih untuk membatalkan cadangan kapan saja setelah salinan bayangan dibuat dengan memanggil IVssAsync::Cancel.

Aplikasi panggilan bertanggung jawab untuk memanggil IUnknown::Release untuk merilis sumber daya yang disimpan oleh IVssAsync yang dikembalikan ketika tidak lagi diperlukan.

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