Metode CVssWriterEx::OnIdentifyEx (vswriter.h)
Mengembalikan penunjuk ke objek IVssCreateWriterMetadataEx .
OnIdentifyEx adalah metode virtual. Ini diimplementasikan oleh kelas dasar CVssWriterEx , tetapi dapat ditimpa oleh kelas turunan.
Sintaks
bool OnIdentifyEx(
[in] IVssCreateWriterMetadataEx *pMetadata
);
Parameter
[in] pMetadata
Penunjuk ke objek IVssCreateWriterMetadataEx .
Mengembalikan nilai
Seperti yang diimplementasikan oleh kelas dasar, OnIdentifyEx 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
Metode OnIdentifyEx identik dengan metode OnIdentify , kecuali bahwa metode tersebut mengembalikan penunjuk antarmuka IVssCreateWriterMetadataEx alih-alih penunjuk antarmuka IVssCreateWriterMetadata dalam parameter pMetadata . Penulis dapat mengambil alih OnIdentify atau OnIdentifyEx, tetapi tidak keduanya.
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 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 memanggil OnIdentifyEx untuk membuat Dokumen Metadata Penulis yang berisi informasi tentang komponen yang dikelolanya menggunakan antarmuka IVssCreateWriterMetadataEx .
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, OnIdentifyEx biasanya dipanggil untuk menangani peristiwa Identifikasi sebagai respons terhadap panggilan pemohon ke IVssBackupComponents::GatherWriterMetadata sebagai bagian dari operasi pencadangan atau pemulihan.
Namun, peristiwa Identifikasi dengan sendirinya bukan bagian dari urutan peristiwa yang membentuk urutan pencadangan atau pemulihan, dan layanan VSS tidak mencegah Mengidentifikasi peristiwa dihasilkan, bahkan saat urutan pencadangan atau pemulihan sedang berlangsung. Misalnya, aplikasi manajemen VSS menggunakan peristiwa Identifikasi untuk menentukan dan menampilkan status penulis pada sistem.
Untuk alasan ini, penulis tidak boleh menggunakan implementasi OnIdentifyEx mereka dengan salah satu cara berikut:
- Sebagai awal penanganannya terhadap urutan pencadangan atau pemulihan
- Untuk mengatur atau mempertahankan informasi tentang status penulis
Selama peristiwa PrepareForBackup, PrepareForSnapshot, dan PostSnapshot , penulis dapat menggunakan metode GetIdentifyInformation untuk mendapatkan metadata yang sebelumnya dilaporkan oleh metode OnIdentifyEx penulis.
Siklus hidup objek IVssCreateWriterMetadataEx yang ditunjuk parameter pMetadata dikelola oleh infrastruktur VSS.
Persyaratan
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | vswriter.h (termasuk Vss.h, VsWriter.h) |
| Pustaka | VssApi.lib |