CVssWriter::Metode OnPreRestore (vswriter.h)

  • Artikel

Metode OnPreRestore dipanggil oleh penulis setelah peristiwa PreRestore . Metode ini digunakan untuk menempatkan penulis dalam status untuk mendukung pemulihan—misalnya, mengambil layanan database secara offline—dan untuk melakukan modifikasi dalam Dokumen Komponen Cadangan pemohon yang memulihkan file (seperti mengatur target pemulihan untuk mengambil alih metode pemulihan asli).

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

Sintaks

bool OnPreRestore(
  [in] IVssWriterComponents *pComponent
);

Parameter

[in] pComponent

Arahkan ke instans objek IVssWriterComponents yang berisi komponen yang terkait dengan penulis saat ini dalam Dokumen Komponen Cadangan pemohon.

Nilai kembali

Seperti yang diimplementasikan oleh kelas dasar, OnPreRestore 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

Peristiwa PreRestore terjadi sebelum data yang dicadangkan sebenarnya sedang dipulihkan. Ini adalah kesempatan bagi penulis untuk menentukan apa yang sedang dipulihkan.

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

Metode ini memungkinkan penulis untuk menentukan apa yang sedang dipulihkan, untuk mengambil metadata privat yang disimpan di Dokumen Komponen Cadangan yang disimpan, dan untuk memperbarui data tersebut.

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::OnPostSnapshot

CVssWriter::OnPrepareBackup

CVssWriter::SetWriterFailure

IVssWriterComponents