Bagikan melalui


Metode IVssBackupComponents::BackupComplete (vsbackup.h)

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

Lihat juga

IVssAsync

IVssAsync::Cancel

IVssAsync::QueryStatus

IVssBackupComponents

IVssBackupComponents::SetBackupState

IVssBackupComponents::SetBackupSucceeded