Isi Dokumen Komponen Cadangan

Dokumen Komponen Cadangan dikelola oleh instans antarmuka IVssBackupComponents . Antarmuka ini juga berisi banyak metode untuk mengontrol operasi pencadangan, memanipulasi salinan bayangan, dan mengkueri status sistem. Namun, tidak semua informasi dokumen dapat diakses langsung melalui antarmuka ini.

Dokumen Komponen Cadangan terdiri dari beberapa set data:

• Informasi tentang komponen mana yang secara eksplisit disertakan dalam operasi pencadangan atau pemulihan
• Representasi informasi komponen dan penulis yang disimpan
• Informasi status tentang operasi pencadangan/pemulihan

Meskipun informasi komponen tersedia untuk pemohon dan penulis, hanya penulis yang memiliki akses ke informasi status.

Informasi Penyertaan Komponen

Dokumen Komponen Cadangan berisi daftar komponen tersebut yang secara eksplisit disertakan dalam pencadangan dan pemulihan oleh pemohon. Daftar ini berisi yang berikut ini:

• Komponen yang dapat dipilih secara eksplisit disertakan.

  Penyertaan file-file ini dalam operasi pencadangan ditunjukkan oleh IVssBackupComponents::AddComponent dan dalam operasi pemulihan oleh IVssBackupComponents::SetSelectedForRestore.

• Tidak dapat dipilih untuk subkomponen cadangan tanpa dapat dipilih untuk leluhur komponen cadangan.

  Semua komponen ini harus disertakan jika ada komponen penulis yang akan disertakan dalam operasi. Penyertaan file-file ini dalam operasi pencadangan ditunjukkan oleh IVssBackupComponents::AddComponent dan dalam operasi pemulihan oleh IVssBackupComponents::SetSelectedForRestore.

• Komponen secara implisit ditambahkan ke cadangan (subkomponen) yang dapat dipilih untuk dipulihkan dan secara eksplisit ditambahkan ke pemulihan.

  Komponen-komponen ini mungkin dapat dipilih atau tidak dapat dipilih, tetapi memiliki leluhur yang dapat dipilih yang digunakan untuk secara implisit memilihnya untuk cadangan. Mereka ditambahkan ke Dokumen Komponen Cadangan oleh IVssBackupComponents::AddRestoreSubcomponent.

Identitas komponen yang disertakan secara implisit dalam pemulihan tidak disimpan dalam Dokumen Komponen Cadangan.

VSS memiliki akses ke informasi tentang penyertaan komponen: penulis tanpa komponen yang secara eksplisit disertakan dalam pemulihan atau pencadangan tidak menerima peristiwa VSS setelah pembuatan peristiwa PrepareForBackup atau PreRestore .

Penulis tidak dapat langsung mengkueri informasi ini. Ini bukan batasan yang signifikan karena secara desain, penulis VSS individu tidak boleh memerlukan informasi terperinci tentang status penulis lain pada sistem dan, seperti yang disebutkan di atas, mereka yang tidak memiliki komponen yang disertakan tidak perlu berpartisipasi dalam operasi VSS.

Pemohon dapat menentukan komponen mana yang telah secara eksplisit disertakan dalam operasi.

Metode IVssBackupComponents::GetWriterComponentsCount mengembalikan jumlah penulis dengan informasi komponen yang disimpan dalam Dokumen Komponen Cadangan (dan bukan jumlah komponen dalam dokumen).

Pemohon mengindeks melalui informasi penulis yang disimpan menggunakan IVssBackupComponents::GetWriterComponents, yang mengembalikan instans antarmuka IVssWriterComponentsExt . Antarmuka IVssWriterComponentsExt memungkinkan pemohon untuk mendapatkan kelas penulis dan instans penulis dari penulis yang berpartisipasi, serta untuk mengakses informasi tentang komponen-komponennya yang disimpan dalam Dokumen Komponen Cadangan.

Informasi tentang Komponen yang Disertakan

Representasi Dokumen Komponen Cadangan dari data komponen (yang tidak menyertakan informasi spesifikasi jalur dan file), yang diakses melalui instans antarmuka IVssComponent .

Pemohon dan penulis mendapatkan akses ke instans antarmuka IVssComponent dengan cara yang berbeda.

Pemohon memeriksa data komponen berdasarkan penulis dengan menggunakan instans antarmuka IVssWriterComponentsExt yang dikembalikan oleh IVssBackupComponents::GetWriterComponents.

Selain informasi identifikasi penulis, antarmuka IVssWriterComponentsExt menyediakan array instans antarmuka IVssComponent —satu untuk setiap komponen yang disertakan penulis yang dipilih.

Seperti yang disebutkan dalam Siklus Hidup Dokumen Komponen Cadangan, penulis dapat memperoleh akses ke informasi yang sama melalui antarmuka IVssWriterComponents saat menangani peristiwa PrepareForBackup, PrepareForSnapshot, PostSnapshot, BackupComplete, PreRestore, atau PostRestore.

IVssComponent memungkinkan penulis dan pemohon untuk mendapatkan informasi berikut:

• Nama, jenis, dan jalur logis komponen (GetComponentName, GetComponentType, GetLogicalPath)
• Bagaimana komponen harus dipulihkan seperti yang ditunjukkan oleh target pemulihan (IVssComponent::GetRestoreTarget)
• Jika lokasi alternatif digunakan dalam memulihkan file (GetAlternateLocationMapping, GetAlternateLocationMappingCount)
• Informasi target baru, jika ada (GetNewTarget, GetNewTargetCount)
• Pesan kesalahan pra-dan pasca-pemulihan (GetPreRestoreFailureMsg, GetPostRestoreFailureMsg)
• Jika komponen cadangan yang dapat dipilih yang menentukan set komponen telah dipilih untuk pemulihan (IsSelectedForRestore)
• Apakah pencadangan atau pemulihan berhasil (GetBackupSucceeded, GetFileRestoreStatus)
• Opsi pencadangan atau pemulihan khusus penulis apa pun yang mungkin telah ditetapkan oleh IVssBackupComponents::SetBackupOptions atau IVssBackupComponents::SetRestoreOptions (GetBackupOptions, GetRestoreOptions)
• Setiap metadata pencadangan atau pemulihan metadata khusus penulis (GetBackupMetadata), GetRestoreMetadata)
• Informasi stempel waktu (GetBackupStamp, GetPreviousBackupStamp)
• Informasi tentang subkomponen cadangan yang secara eksplisit disertakan dalam pemulihan (GetRestoreSubcomponent, GetRestoreSubcomponentCount)

Tidak seperti pemohon, penulis dapat mengubah informasi tertentu di Dokumen Komponen Cadangan melalui antarmuka IVssComponent :

• Bagaimana komponen harus dipulihkan seperti yang ditunjukkan oleh target pemulihan (IVssComponent::SetRestoreTarget)
• Metadata pencadangan dan pemulihan khusus penulis (IVssComponent::SetBackupMetadata, IVssComponent::SetRestoreMetadata)
• Informasi stempel waktu (SetBackupStamp)
• Pesan kesalahan pra-dan pasca-pemulihan (SetPreRestoreFailureMsg, SetPostRestoreFailureMsg)

Informasi Status Pemohon

Pemohon menyisipkan informasi tentang status operasi pencadangan atau pemulihan ke dalam Dokumen Komponen Cadangan menggunakan antarmuka IVssBackupComponents . Aplikasi penulis dapat mengkueri informasi ini melalui kelas CVssWriter .

Informasi status yang disimpan dalam Dokumen Komponen Cadangan mencakup yang berikut ini:

Informasi Umum tentang Pencadangan

• Jenis cadangan keseluruhan (inkremental, diferensial, atau penuh)

Diatur oleh pemohon menggunakan IVssBackupComponents::SetBackupState

Diambil oleh penulis menggunakan CVssWriter::GetBackupType

- Apakah operasi komponen didukung

Diatur oleh pemohon menggunakan IVssBackupComponents::SetBackupState

Diambil oleh penulis menggunakan CVssWriter::AreComponentsSelected

- Apakah status sistem yang dapat di-boot dicadangkan

Diatur oleh pemohon menggunakan IVssBackupComponents::SetBackupState

Diambil oleh penulis menggunakan CVssWriter::IsBootableStateBackedUp

- Apakah operasi file parsial didukung

Diatur oleh pemohon menggunakan IVssBackupComponents::SetBackupState

Diambil oleh penulis menggunakan CVssWriter::IsPartialFileSupportEnabled

Informasi Umum tentang Pemulihan

• Jenis pemulihan keseluruhan (apakah pemulihan adalah dengan menyalin atau mengimpor)

Diatur oleh pemohon menggunakan IVssBackupComponents::SetRestoreState

Diambil oleh penulis menggunakan CVssWriter::GetRestoreType

Informasi tentang File Pendukung

• Lokasi rentang file yang digunakan oleh komponen tertentu dalam operasi file parsial

Diatur oleh pemohon menggunakan IVssBackupComponents::SetRangesFilePath

Diambil oleh penulis (atau pemohon) menggunakan IVssComponent::GetPartialFile

Status Informasi

• Menunjukkan apakah salah satu komponen penulis tertentu berhasil dicadangkan

Diatur oleh pemohon menggunakan IVssBackupComponents::SetBackupSucceeded

Diambil oleh penulis dan pemohon menggunakan IVssComponent::GetBackupSucceeded

- Menunjukkan apakah salah satu komponen penulis yang diberikan berhasil dipulihkan

Diatur oleh pemohon menggunakan IVssBackupComponents::SetFileRestoreStatus

Diambil oleh penulis dan pemohon menggunakan IVssComponent::GetFileRestoreStatus

Informasi Writer-Settable

• Spesifikasi cadangan tambahan untuk salah satu komponen penulis tertentu

Diatur oleh penulis menggunakan IVssComponent::SetBackupMetadata

Diambil oleh penulis dan pemohon menggunakan IVssComponent::GetBackupMetadata

- Spesifikasi pemulihan tambahan untuk salah satu komponen penulis tertentu

Diatur oleh penulis menggunakan IVssComponent::SetRestoreMetadata

Diambil oleh penulis dan pemohon menggunakan IVssComponent::GetRestoreMetadata

- Stempel cadangan yang menunjukkan, dalam format spesifik penulis sendiri, waktu pencadangan saat ini dari salah satu cadangan komponennya

Diatur oleh penulis menggunakan IVssComponent::SetBackupStamp

Diambil oleh penulis dan pemohon menggunakan IVssComponent::GetBackupStamp

- Stempel cadangan yang menunjukkan, dalam format spesifik penulis sendiri, waktu pencadangan terakhir dari salah satu cadangan komponennya menggunakan stempel cadangan yang awalnya diatur oleh IVssComponent::SetBackupStamp

Disimpan dan diatur oleh pemohon untuk komponen tertentu menggunakan IVssBackupComponents::SetPreviousBackupStamp

Diambil oleh penulis dan pemohon menggunakan IVssComponent::GetPreviousBackupStamp

- Pesan kesalahan untuk kegagalan sebelum dan sesudah operasi pemulihan

Diatur oleh penulis menggunakan IVssComponent::SetPreRestoreFailureMsg atau IVssComponent::SetPostRestoreFailureMsg

Diambil oleh penulis dan pemohon menggunakan IVssComponent::GetPreRestoreFailureMsg atau IVssComponent::GetPostRestoreFailureMsg