Penggunaan Komponen oleh Pemohon
Selain melakukan pencadangan atau pemulihan, dan mengawasi salinan bayangan, pemohon harus mengelola informasi tentang komponen penulis yang berinteraksi dengannya. Pemilih komponen dan jalur logis digunakan untuk menyertakan atau mengecualikan data dari cadangan, dan untuk memutuskan informasi komponen apa yang disertakan dalam Dokumen Komponen Cadangan.
Pemilihan Komponen Pemohon selama Pencadangan
Selama operasi pencadangan, pemohon mengimpor data komponen metadata penulis menggunakan metode IVssBackupComponents::GatherWriterMetadata dan IVssBackupComponents::GetWriterMetadata (lihat Gambaran Umum Inisialisasi Cadangan untuk informasi selengkapnya).
Setelah memeriksa informasi penulis dengan antarmuka IVssExamineWriterMetadata, pemohon memutuskan penulis mana yang akan dicadangkannya dan, sampai batas terbatas, komponen penulis tertentu yang akan dicadangkannya.
Saat mencadangkan penulis, pemohon:
- Harus secara eksplisit menyertakan semua penulis yang tidak dapat dipilih untuk komponen cadangan tanpa dapat dipilih untuk leluhur cadangan menggunakan IVssBackupComponents::AddComponent untuk menambahkan komponen ke Dokumen Komponen Cadangan
- Dapat secara eksplisit menyertakan salah satu penulis yang dapat dipilih untuk komponen cadangan menggunakan IVssBackupComponents::AddComponent untuk menambahkan komponen ke Dokumen Komponen Cadangan
- Jika komponen cadangan yang dapat dipilih menentukan set komponen, penyertaan eksplisitnya secara implisit mencakup semua anggota set komponen—baik yang dapat dipilih untuk cadangan atau tidak. Komponen-komponen ini tidak ditambahkan ke Dokumen Komponen Cadangan.
Dalam menambahkan yang dapat dipilih untuk komponen cadangan atau tidak dapat dipilih untuk komponen cadangan tanpa dapat dipilih untuk leluhur cadangan ke Dokumen Komponen Cadangannya, pemohon menentukan hal berikut:
- Instans penulis yang mengelola komponen
- Pengidentifikasi kelas penulis
- Jalur logis komponen (yang mungkin NULL)
- Nama komponen
Jika komponen tidak cocok dengan spesifikasi, kesalahan akan dikembalikan.
Jika komponen seperti itu ada, VSS membuat antarmuka IVssComponent untuk komponen dalam Dokumen Komponen Cadangan. Informasi ini akan dapat diakses dan dimodifikasi oleh penulis dan pemohon. Untuk komponen yang dapat dipilih yang mendefinisikan set komponen, komponen ini tidak hanya menjelaskan properti komponen tetapi juga semua subkomponen yang dikandungnya.
Informasi tentang komponen yang ditambahkan secara implisit tidak tersedia di Dokumen Komponen Cadangan. Selain itu, tidak ada informasi file yang tersedia di Dokumen Komponen Cadangan. Untuk mendapatkan informasi tersebut, pemohon harus memeriksa Dokumen Metadata Penulis (yang akan telah dibaca) dalam konteks komponen tersimpan yang dipilih dalam Dokumen Komponen Cadangan.
Pemilihan Komponen Pemohon selama Pemulihan
Selama operasi pemulihan, pemohon tidak boleh mengimpor informasi komponen dari penulis yang saat ini aktif pada sistem melalui IVssBackupComponents::GatherWriterMetadata, karena status proses yang saat ini dijalankan tidak akan selalu mencerminkan status proses ketika cadangan dibuat.
Ini masih harus menghasilkan peristiwa Identifikasi melalui IVssBackupComponents::GatherWriterMetadata, baik untuk membuat peristiwa Identifikasi dan untuk menentukan penulis mana yang saat ini ada di sistem dan statusnya.
Pemohon mengambil Dokumen Komponen Cadangan yang disimpan selama inisialisasi serta Dokumen Metadata Penulis yang disimpan (lihat Gambaran Umum Inisialisasi Pemulihan untuk informasi selengkapnya) .
Penyertaan komponen selama pencadangan sebagian besar sama dengan untuk pemulihan, kecuali bahwa Anda harus mempertimbangkan untuk pemulihan bersama dengan jalur logis—tidak dapat dipilih untuk pencadangan.
Namun, ada beberapa perbedaan:
- Jika komponen telah secara eksplisit disertakan ke Dokumen Komponen Cadangan selama pencadangan, jika disertakan untuk pemulihan (baik secara eksplisit atau implisit), IVssBackupComponents::SetSelectedForRestore digunakan untuk secara eksplisit menambahkannya ke Dokumen Komponen Cadangan untuk pemulihan.
- Jika komponen disertakan secara implisit ke cadangan, dan tidak dapat dipilih untuk pemulihan tanpa dipilih untuk leluhur pemulihan—yang dalam kasus cadangan akan menyiratkan perlunya penyertaan eksplisit—komponen tidak disertakan secara eksplisit (artinya, tidak ditambahkan ke Dokumen Komponen Cadangan menggunakan IVssBackupComponents::SetSelectedForRestore). Komponen semacam itu harus dianggap dipilih secara implisit untuk pemulihan.
- Dari komponen tersebut secara implisit dipilih untuk pencadangan (apakah komponen tersebut dapat dipilih untuk pencadangan atau tidak), hanya komponen yang dapat dipilih untuk pemulihan yang dapat ditambahkan ke Dokumen Komponen Cadangan menggunakan IVssBackupComponents::AddRestoreSubcomponent.
- Dapat dipilih untuk komponen pemulihan dapat menentukan set komponen untuk pemulihan—sama seperti yang dapat dipilih untuk komponen cadangan. Ini dapat dipilih untuk komponen pemulihan kemudian mendefinisikan set komponen ini untuk operasi pemulihan.
Penulis tanpa komponen yang secara eksplisit dipilih untuk dipulihkan sebelum pembuatan peristiwa PreRestore tidak akan menerima peristiwa VSS apa pun.
Pemohon dan penulis dapat mengakses informasi komponen yang disimpan menggunakan antarmuka IVssComponent . Melalui antarmuka IVssComponent , penulis dapat memodifikasi beberapa pengaturan komponennya yang secara eksplisit disertakan dalam Dokumen Komponen Cadangan untuk mendukung pemulihan (seperti target pemulihan). Jika mendefinisikan set komponen, modifikasi penulis dari komponen yang disertakan secara eksplisit akan menyebar ke subkomponennya. Selain itu, antarmuka menyediakan mekanisme untuk meneruskan informasi tentang keberhasilan pemulihan dan kegagalan antara penulis dan pemohon.
Seperti selama pencadangan, tidak ada informasi yang cukup dalam Dokumen Komponen Cadangan itu sendiri untuk mengimplementasikan pemulihan. Sekali lagi, Dokumen Metadata Penulis akan diperlukan untuk menyediakan informasi tentang jalur file aktual yang akan dipulihkan dan untuk menemukan komponen apa yang tidak dapat dipilih adalah bagian dari set komponen yang dapat dipilih dan oleh karena itu perlu dipulihkan.
Lihat Bekerja dengan Keterpilihan dan Jalur Logis untuk informasi tentang jenis keterpilihan dan penggunaannya.
Penggunaan Informasi Dokumen Komponen Penulis oleh Pemohon
Setiap komponen diidentifikasi secara unik oleh ID Kelas Penulis dari penulis induknya, namanya, dan jalur logisnya.
Pemohon dapat menggunakan antarmuka IVssWriterComponentsExt yang dikembalikan oleh metode IVssBackupComponents::GetWriterComponents untuk mendapatkan informasi tentang setiap komponen yang disimpan.
Nama komponen dan jalur logis (di antara item lainnya) dapat ditemukan melalui antarmuka IVssComponent yang dikembalikan oleh IVssWriterComponentsExt::GetComponent.
Catatan
Selama fase pemulihan, pemohon harus memanggil IVssWriterComponentsExt::GetComponent atau IVssWriterComponentsExt::GetComponentCount hanya setelah panggilan ke IVssBackupComponents::P reRestore telah kembali, untuk memungkinkan waktu bagi penulis untuk memperbarui Dokumen Komponen Cadangan. Salah satu contoh pembaruan tersebut adalah mengubah target pemulihan.
Informasi tentang setiap penulis induk komponen yang dapat dipilih yang disimpan dapat ditemukan menggunakan IVssWriterComponentsExt::GetWriterInfo.
Dengan informasi ini, Dokumen Metadata Penulis dapat dikueri dan dokumen yang cocok diidentifikasi. Kemudian, dengan menggunakan jalur logis, pemohon dapat mengidentifikasi komponen dependen yang tidak dapat dipilih untuk setiap komponen yang dapat dipilih—yaitu, mengidentifikasi semua anggota set komponen yang dapat dipilih.
Menggunakan antarmuka IVssExamineWriterMetadata, pemohon sekarang memiliki informasi komponen lengkap—termasuk spesifikasi jalur (dari antarmuka IVssWMComponent )—untuk komponen yang dapat dipilih dan tidak dapat dipilih yang perlu dicadangkan atau dipulihkan.
Ini adalah salah satu alasan mengapa sangat penting bagi pemohon untuk menyimpan status Dokumen Komponen Cadangannya sendiri dan Dokumen Metadata Penulis dari penulis yang dicadangkannya.
Lihat Bekerja dengan Selektabilitas dan Jalur Logis untuk informasi lebih rinci.