CVssWriter::Metode OnPostRestore (vswriter.h)

  • Artikel

Metode OnPostRestore dipanggil oleh penulis setelah peristiwa PostRestore . Ini digunakan untuk melakukan operasi yang dianggap perlu setelah file dipulihkan ke disk oleh pemohon. Namun, operasi ini tidak dapat mengubah Dokumen Komponen Cadangan.

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

Sintaks

bool OnPostRestore(
  [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, OnPostRestore 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 perlu, penulis harus menghapus file sementara dan merilis sumber daya sistem apa pun yang diperlukan untuk partisipasinya dalam pemulihan.

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

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

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

IVssWriterComponents