Bekerja dengan Keterpilihan Untuk Pemulihan dan Subkomponen
Pemilih untuk pemulihan memungkinkan pemohon menentukan kapan komponen dapat dipulihkan secara individual. Komponen yang telah disertakan untuk cadangan dapat muncul dengan salah satu dari dua cara:
- Komponen mungkin telah secara eksplisit disertakan dalam cadangan. Komponen-komponen ini memiliki instans IVssComponent yang sesuai di Dokumen Komponen Cadangan. Komponen-komponen ini disertakan dalam pemulihan menggunakan IVssBackupComponents::SetSelectedForRestore.
- Komponen mungkin telah disertakan secara implisit dalam cadangan. Komponen-komponen ini tidak memiliki instans IVssComponent yang sesuai dalam Dokumen Komponen Cadangan; namun, akan selalu ada instans IVssComponent untuk beberapa komponen leluhur dalam dokumen. Komponen-komponen ini disertakan dalam pemulihan menggunakan IVssBackupComponents::AddRestoreSubcomponent.
Komponen apa pun yang telah secara eksplisit disertakan dalam cadangan selalu dapat dipilih secara individual untuk pemulihan, terlepas dari nilai selectability-for-restore-nya. Pemohon memanggil IVssBackupComponents::SetSelectedForRestore, meneruskan ID penulis, jalur logis, dan nama komponen tertentu. Komponen yang telah secara implisit disertakan dalam cadangan akan dipulihkan ketika leluhur yang disertakan secara eksplisit dipulihkan. Komponen yang disertakan secara implisit dapat dipilih secara individual untuk dipulihkan hanya jika ditandai sebagai dapat dipilih untuk dipulihkan. Pemohon pertama kali memanggil IVssBackupComponents::SetSelectedForRestore pada komponen leluhur terdekat yang disertakan secara eksplisit, lalu memanggil IVssBackupComponents::AddRestoreSubcomponent pada komponen leluhur untuk memilih komponen yang disertakan secara implisit untuk pemulihan. Setelah ini selesai, hanya komponen yang dipilih secara implisit yang akan dipulihkan; semua komponen lain dalam set komponen tidak akan dipulihkan.
Tidak seperti pemilihan untuk pencadangan, yang harus selalu diatur secara eksplisit ketika komponen ditambahkan dengan IVssCreateWriterMetadata::AddComponent, keterpilihan untuk pemulihan memiliki nilai default false, yang dapat ditimpa.
Karena komponen tingkat atas (komponen dengan jalur logika kosong) hanya dapat secara eksplisit disertakan dalam cadangan, keterpilihan untuk pemulihan tidak memiliki arti untuk komponen ini.