CVssWriter::Metode OnAbort (vswriter.h)

Artikel
03/03/2024

Metode OnAbort dipanggil oleh penulis setelah peristiwa Pembatalan yang dikeluarkan oleh VSS yang menunjukkan bahwa operasi salinan bayangan telah dihentikan sebelum waktunya. Penulis menggunakan metode ini untuk membersihkan dari upayanya untuk berpartisipasi dalam operasi itu.

OnAbort adalah metode virtual murni. Ini tidak diimplementasikan oleh kelas dasar CVssWriter , dan harus diimplementasikan oleh kelas turunan.

Sintaks

bool OnAbort();

Mengembalikan nilai

Implementasi 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 harus tetap 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 pasti kegagalan tersebut.

Keterangan

Dalam metode ini, penulis harus membebaskan semua sumber daya sistem sementara yang dibuatnya saat bersiap untuk berpartisipasi dengan operasi VSS.

Penulis tidak akan menerima pemberitahuan peristiwa lebih lanjut yang terkait dengan operasi VSS yang diikutinya setelah CVssWriter::OnAbort dijalankan.

Metode ini tidak akan dipanggil jika penulis telah memanggil CVssWriter::OnPostSnapshot (yaitu, menerima pemberitahuan akhir salinan bayangan).

Peristiwa Pembatapan dihasilkan saat:

Penanganan aktivitas Freeze and Thaw penulis (CVssWriter::OnFreeze dan CVssWriter::OnThaw) mengembalikan false, atau tidak dapat menyelesaikan di jendela waktu yang ditentukan dalam CVssWriter::Initialize.
Pemohon secara eksplisit menghasilkan peristiwa Pembatalan dengan memanggil IVssBackupComponents::AbortBackup.
Ada kegagalan penyedia atau VSS selama pembuatan salinan bayangan setelah peristiwa PrepareForSnapshot .

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

Jika metode ini memanggil metode CVssWriterEx2::GetSessionId, CVssWriter::SetWriterFailure, atau CVssWriterEx2::SetWriterFailureEx , metode harus melakukannya dalam utas yang sama yang memanggil 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