CVssWriter::Metode OnPrepareSnapshot (vswriter.h)

Artikel
08/27/2023

Metode OnPrepareSnapshot dipanggil oleh penulis untuk menangani peristiwa PrepareForSnapshot . Ini digunakan untuk melakukan operasi yang diperlukan untuk menyiapkan penulis untuk berpartisipasi dalam salinan bayangan atau untuk mem-veto salinan bayangan.

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

Sintaks

bool OnPrepareSnapshot();

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

Metode OnPrepareSnapshot melakukan operasi yang diperlukan sebelum salinan bayangan membeku.

Jendela waktu habis untuk menangani peristiwa PrepareForSnapshot biasanya lebih panjang dari itu untuk menangani peristiwa Freeze . Oleh karena itu, pengembang dapat menggunakan OnPrepareSnapshot untuk menangani operasi yang lebih memakan waktu. Penggunaan umum mungkin bagi penulis untuk secara eksplisit memeriksa datanya.

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

Lihat juga

CVssWriter::SetWriterFailure