Metode CVssWriter::OnBackupComplete (vswriter.h)

  • Artikel

Metode OnBackupComplete dipanggil oleh penulis setelah peristiwa BackupComplete . Ini digunakan untuk melakukan operasi yang dianggap perlu setelah pencadangan. Namun, operasi ini tidak dapat mengubah Dokumen Komponen Cadangan.

OnBackupComplete adalah metode virtual. Ini diimplementasikan oleh kelas dasar CVssWriter , tetapi dapat ditimpa oleh kelas turunan.

Sintaks

bool OnBackupComplete(
  [in] IVssWriterComponents *pComponent
);

Parameter

[in] pComponent

Penunjuk ke objek IVssWriterComponents yang diteruskan oleh VSS untuk menyediakan metode dengan akses ke informasi komponen penulis. Nilai parameter ini mungkin NULL jika pemohon tidak mendukung komponen (jika CVssWriter::AreComponentsSelected mengembalikan false).

Mengembalikan nilai

Seperti yang diimplementasikan oleh kelas dasar, OnBackupComplete selalu mengembalikan true.

Implementasi lain dari metode ini harus mengembalikan true kecuali dalam kasus kesalahan fatal. Jika terjadi kesalahan fatal, metode harus memanggil metode CVssWriter::SetWriterFailure untuk memberikan deskripsi kegagalan sebelum mengembalikan false. Jika terjadi kesalahan nonfatal, metode masih harus memanggil SetWriterFailure tetapi mengembalikan true. Jika kesalahan disebabkan oleh masalah sementara, metode harus menentukan VSS_E_WRITERERROR_RETRYABLE dalam panggilan ke SetWriterFailure.

Dalam semua kasus ketika kegagalan terjadi, metode harus menulis peristiwa ke log peristiwa untuk melaporkan alasan yang tepat untuk kegagalan tersebut.

Keterangan

Implementasi default metode ini oleh kelas dasar CVssWriter mengembalikan true tanpa melakukan operasi lain.

Jika operasi khusus harus dilakukan oleh penulis di akhir cadangan, implementasi default dapat ditimpa.

Dengan pembuatan peristiwa BackupComplete , Dokumen Komponen Cadangan pemohon menjadi dokumen baca-saja. Oleh karena itu, upaya untuk memodifikasi dokumen melalui antarmuka (misalnya, memanggil IVssComponent::SetBackupMetadata) akan gagal dalam implementasi pengguna OnBackupComplete.

Aplikasi pencadangan yang berhasil akan menghasilkan peristiwa BackupComplete ketika semua data telah disimpan ke media cadangan.

Namun, tidak ada jaminan penulis menerima pemberitahuan peristiwa BackupComplete , karena ini mengharuskan aplikasi cadangan untuk berhasil menyelesaikan pencadangan atau gagal dengan baik.

Peristiwa BackupComplete dapat gagal dihasilkan jika aplikasi cadangan dihentikan oleh sistem atau secara manual sebelum penyelesaian pencadangan (misalnya, jika operasi pencadangan menggantung dan harus dimatikan).

Penulis harus mempertahankan informasi status sehingga dapat melacak apakah peristiwa BackupComplete dikirim untuk set salinan bayangan tertentu.

Informasi ini dapat digunakan oleh penanganan aktivitas BackupShutdown penulis (CVssWriter::OnBackupShutdown), yang akan dipanggil ketika aplikasi cadangan benar-benar dihentikan dan IVssBackupComponents dirilis, untuk melakukan operasi pembersihan jika tidak ada panggilan ke OnBackupComplete.

Penulis tidak boleh melempar pengecualian dari metode ini atau CVssWriter lainnya(Mis)::Pada metode panggilan balikXxx .

Jika metode ini memanggil metode CVssWriterEx2::GetSessionId, CVssWriter::SetWriterFailure, atau CVssWriterEx2::SetWriterFailureEx , metode tersebut harus melakukannya dalam utas yang sama yang disebut metode ini. Untuk informasi selengkapnya, lihat Penanganan Peristiwa Penulis.

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 vswriter.h (termasuk Vss.h, VsWriter.h)
Pustaka VssApi.lib

Lihat juga

CVssWriter

CVssWriter::SetWriterFailure

IVssBackupComponents

IVssWriterComponents