CVssWriter::Metode OnIdentify (vswriter.h)

  • Artikel

Metode OnIdentify dipanggil oleh penulis setelah menerima peristiwa Identifikasi .

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

Sintaks

bool OnIdentify(
  [in] IVssCreateWriterMetadata *pMetadata
);

Parameter

[in] pMetadata

Penunjuk ke objek IVssCreateWriterMetadata yang digunakan untuk membangun metadata penulis.

Nilai kembali

Seperti yang diimplementasikan oleh kelas dasar, OnIdentify selalu mengembalikan true.

Implementasi lain dari metode ini harus mengembalikan true kecuali dalam kasus kesalahan fatal. Jika terjadi kesalahan fatal, metode harus mengembalikan false.

Dalam semua kasus ketika kegagalan terjadi, termasuk kesalahan nonfatal, metode harus menulis entri terperinci ke log peristiwa untuk melaporkan alasan pasti kegagalan tersebut.

Keterangan

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

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

Penulis tidak boleh memanggil metode CVssWriter::SetWriterFailure dari metode OnIdentify atau CVssWriterEx::OnIdentifyEx .

Jika metode ini memanggil metode CVssWriterEx2::GetSessionId , metode ini harus melakukannya dalam utas yang sama yang disebut metode ini. Untuk informasi selengkapnya, lihat Penanganan Peristiwa Penulis.

Menanggapi peristiwa Identifikasi yang dihasilkan oleh aplikasi lain, penulis menggunakan handler OnIdentify untuk membuat Dokumen Metadata Penulis yang berisi informasi tentang komponen yang dikelolanya menggunakan antarmuka IVssCreateWriterMetadata .

Aplikasi yang menghasilkan peristiwa Identifikasi kemudian mengambil Dokumen Metadata Penulis dan memeriksa informasi komponen penulis menggunakan antarmuka IVssExamineWriterMetadata .

Peristiwa Identifikasi diperlukan sebelum peristiwa yang membentuk urutan pencadangan atau pemulihan. Oleh karena itu, OnIdentify mungkin paling sering dipanggil untuk menangani peristiwa Identifikasi sebagai respons terhadap panggilan pemohon ke IVssBackupComponents::GatherWriterMetadata sebagai bagian dari operasi pencadangan atau pemulihan.

Namun, peristiwa Identifikasi bukan bagian dari urutan peristiwa yang membentuk cadangan atau pemulihan dan layanan VSS tidak mencegah pembuatannya, bahkan saat urutan pencadangan atau pemulihan sedang berlangsung. Misalnya, aplikasi manajemen VSS menggunakan peristiwa Identifikasi untuk menentukan dan menampilkan status penulis pada sistem.

Hal ini terjadi, penulis tidak boleh menggunakan implementasi OnIdentify mereka dengan cara berikut:

  • Sebagai awal penanganan pencadangan atau pemulihan mereka
  • Untuk mengatur atau mempertahankan informasi tentang status penulis
Lihat Penanganan Peristiwa Penulis untuk informasi selengkapnya tentang interaksi penulis dengan peristiwa.

Siklus hidup objek IVssCreateWriterMetadata yang diteruskan ke OnIdentify dikelola oleh infrastruktur VSS.

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

IVssBackupComponents::GatherWriterMetadata

IVssCreateWriterMetadata