Metode CVssWriter::OnBackupShutdown (vswriter.h)

  • Artikel

Metode OnBackupShutdown dipanggil oleh penulis setelah peristiwa BackupShutdown . Ini digunakan untuk melakukan operasi yang dianggap perlu ketika aplikasi cadangan dimatikan, terutama dalam kasus crash aplikasi cadangan.

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

Sintaks

bool OnBackupShutdown(
  [in] VSS_ID SnapshotSetId
);

Parameter

[in] SnapshotSetId

Pengidentifikasi untuk set salinan bayangan yang terlibat dalam operasi pencadangan.

Mengembalikan nilai

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

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

Jika operasi khusus harus dilakukan oleh penulis ketika aplikasi cadangan dimatikan, implementasi default dapat ditimpa.

Jika tidak ada salinan bayangan yang berhasil dilakukan, nilai pengidentifikasi set salinan bayangan (SnapshotSetId) akan null.

Peristiwa BackupShutdown akan dihasilkan setiap kali aplikasi cadangan benar-benar dihentikan dan IVssBackupComponents dirilis.

Peristiwa BackupComplete mengharuskan aplikasi pencadangan berhasil menyelesaikan pencadangan atau gagal dengan baik; ini mungkin tidak terjadi jika aplikasi cadangan dihentikan oleh sistem atau dihentikan secara manual sebelum penyelesaian cadangan (misalnya, jika operasi pencadangan menggantung dan harus dimatikan).

Karena itu, peristiwa BackupShutdown adalah sinyal yang lebih kuat dari akhir aplikasi cadangan daripada peristiwa BackupComplete .

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

Setiap implementasi khusus penulis dari OnBackupShutdown harus memeriksa apakah peristiwa BackupComplete ditangani. Ini harus memastikan bahwa semua operasi pembersihan penulis yang diperlukan setelah pencadangan (berhasil atau sebaliknya) telah diformat sebelumnya.

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

   
Klien minimum yang didukung Windows Vista [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::OnBackupComplete

CVssWriter::SetWriterFailure

IVssBackupComponents::BackupComplete