enumerasi VSS_FILE_SPEC_BACKUP_TYPE (vss.h)

Artikel
08/27/2023

Enumerasi VSS_FILE_SPEC_BACKUP_TYPE digunakan oleh penulis untuk menunjukkan dukungan mereka terhadap operasi pencadangan tertentu—seperti pencadangan bertahap atau diferensial—berdasarkan kumpulan file (file atau file tertentu).

Set file yang disimpan dalam Dokumen Metadata Penulis ditandai dengan masker bit (atau bitwise OR) dari nilai VSS_FILE_SPEC_BACKUP_TYPE yang menunjukkan hal berikut:

Apakah penulis dan pemohon harus mengevaluasi kumpulan file tertentu untuk partisipasi dalam jenis operasi pencadangan yang ditentukan
Apakah mencadangkan file yang ditentukan akan memerlukan salinan bayangan

Sintaks

typedef enum _VSS_FILE_SPEC_BACKUP_TYPE {
  VSS_FSBT_FULL_BACKUP_REQUIRED = 0x1,
  VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED = 0x2,
  VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED = 0x4,
  VSS_FSBT_LOG_BACKUP_REQUIRED = 0x8,
  VSS_FSBT_FULL_SNAPSHOT_REQUIRED = 0x100,
  VSS_FSBT_DIFFERENTIAL_SNAPSHOT_REQUIRED = 0x200,
  VSS_FSBT_INCREMENTAL_SNAPSHOT_REQUIRED = 0x400,
  VSS_FSBT_LOG_SNAPSHOT_REQUIRED = 0x800,
  VSS_FSBT_CREATED_DURING_BACKUP = 0x10000,
  VSS_FSBT_ALL_BACKUP_REQUIRED = 0xf,
  VSS_FSBT_ALL_SNAPSHOT_REQUIRED = 0xf00
} VSS_FILE_SPEC_BACKUP_TYPE, *PVSS_FILE_SPEC_BACKUP_TYPE;

Konstanta


`VSS_FSBT_FULL_BACKUP_REQUIRED` Nilai: 0x1 Kumpulan file yang ditandai dengan nilai ini harus terlibat dalam semua jenis operasi pencadangan. Penulis menandai set file dengan nilai ini untuk menunjukkan kepada pemohon bahwa ia mengharapkan salinan saat ini versi set file yang akan tersedia setelah pemulihan operasi pencadangan apa pun dengan VSS_BACKUP_TYPE dari VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED` Nilai: 0x2 Penulis menandai set file dengan nilai ini untuk menunjukkan kepada pemohon bahwa ia mengharapkan salinan saat ini versi set file yang akan tersedia setelah pemulihan operasi pencadangan apa pun dengan VSS_BACKUP_TYPE dari VSS_BT_DIFFERENTIAL. Nilai ini tidak didukung untuk penulis ekspres.
`VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED` Nilai: 0x4 Penulis menandai set file dengan nilai ini untuk menunjukkan kepada pemohon bahwa ia mengharapkan salinan saat ini versi set file yang akan tersedia setelah pemulihan operasi pencadangan apa pun dengan VSS_BACKUP_TYPE dari VSS_BT_INCREMENTAL. Nilai ini tidak didukung untuk penulis ekspres.
`VSS_FSBT_LOG_BACKUP_REQUIRED` Nilai: 0x8 Penulis menandai set file dengan nilai ini untuk menunjukkan kepada pemohon bahwa ia mengharapkan salinan saat ini versi set file yang akan tersedia setelah pemulihan operasi pencadangan apa pun dengan VSS_BACKUP_TYPE dari VSS_BT_LOG. Nilai ini tidak didukung untuk penulis ekspres.
`VSS_FSBT_FULL_SNAPSHOT_REQUIRED` Nilai: 0x100 Kumpulan file yang ditandai dengan nilai ini harus dicadangkan dari salinan bayangan volume (dan tidak pernah dari volume asli) saat berpartisipasi dalam operasi pencadangan dengan VSS_BACKUP_TYPE dari VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_SNAPSHOT_REQUIRED` Nilai: 0x200 Kumpulan file yang ditandai dengan nilai ini harus dicadangkan dari salinan bayangan volume (dan tidak pernah dari volume asli) saat berpartisipasi dalam operasi pencadangan dengan VSS_BACKUP_TYPE dari VSS_BT_DIFFERENTIAL.
`VSS_FSBT_INCREMENTAL_SNAPSHOT_REQUIRED` Nilai: 0x400 Kumpulan file yang ditandai dengan nilai ini harus dicadangkan dari salinan bayangan volume (dan tidak pernah dari volume asli) saat berpartisipasi dalam operasi pencadangan dengan VSS_BACKUP_TYPE dari VSS_BT_INCREMENTAL.
`VSS_FSBT_LOG_SNAPSHOT_REQUIRED` Nilai: 0x800 Kumpulan file yang ditandai dengan nilai ini harus dicadangkan dari salinan bayangan volume (dan tidak pernah dari volume asli) saat berpartisipasi dalam operasi pencadangan dengan VSS_BACKUP_TYPE dari VSS_BT_LOG).
`VSS_FSBT_CREATED_DURING_BACKUP` Nilai: 0x10000 Penulis menandai file yang ditetapkan dengan nilai ini untuk menunjukkan kepada pemohon bahwa mereka mengharapkan file dibuat selama urutan rekam jepret.
`VSS_FSBT_ALL_BACKUP_REQUIRED` Nilai: 0xf Jenis spesifikasi pencadangan file default. Set file yang ditandai dengan nilai ini harus selalu berpartisipasi dalam operasi pencadangan dan pemulihan.
`VSS_FSBT_ALL_SNAPSHOT_REQUIRED` Nilai: 0xf00 Persyaratan salinan bayangan untuk pencadangan. Kumpulan file yang ditandai dengan nilai ini harus selalu dicadangkan dari salinan bayangan volume (dan tidak pernah dari volume asli) saat berpartisipasi dalam operasi pencadangan.

Keterangan

Ketika penulis menetapkan nilai yang diperlukan cadangan dari enumerasi VSS_FILE_SPEC_BACKUP_TYPE , itu menunjukkan bahwa pemohon melakukan pencadangan sedih sehingga, ketika cadangan dipulihkan, versi set file saat ini dipulihkan. Biasanya, ini berarti bahwa kumpulan file disalin sebagai bagian dari cadangan.

Pengaturan ini dapat ditimpa jika file ditambahkan ke Dokumen Komponen Cadangan sebagai file yang berbeda (menggunakan IVssComponent::AddDifferencedFilesByLastModifyTime) atau sebagai file parsial (menggunakan IVssComponent::AddPartialFile).

Jika file ditambahkan sebagai file yang berbeda, penulis menetapkan kriteria di mana pemohon harus memutuskan apakah akan benar-benar menyalin file ke media cadangan atau tidak. Penulis biasanya menambahkan file yang berbeda ke Dokumen Komponen Cadangan untuk dimasukkan dalam peristiwa PostSnapshot cadangan (lihat CVssWriter::OnPostSnapshot). Lihat Pencadangan Inkremental dan Diferensial untuk detailnya.

Ketika penulis menetapkan nilai enumerasi yang diperlukan salinan bayangan dari enumerasi VSS_FILE_SPEC_BACKUP_TYPE , itu menunjukkan bahwa kumpulan file harus dicadangkan dari volume yang disalin bayangan. Set file yang tidak ditandai dengan nilai salinan bayangan yang diperlukan dapat dicadangkan dari volume asli.

Penulis menetapkan nilai VSS_FILE_SPEC_BACKUP_TYPE saat menangani peristiwa Identifikasi (lihat CVssWriter::OnIdentify).

Masker bit (atau bitwise OR) dari nilai VSS_FILE_SPEC_BACKUP_TYPE dapat diterapkan ke set file saat menambahkannya ke komponen menggunakan IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFiles, atau metode IVssCreateWriterMetadata::AddDatabaseLogFiles .

Jika tidak ada jenis cadangan spesifikasi file eksplisit yang disediakan selama penambahan spesifikasi file ke komponen, spesifikasi ditandai dengan nilai VSS_FILE_SPEC_BACKUP_TYPE default: (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).

Pemohon atau penulis dapat memulihkan jenis cadangan spesifikasi file set file dengan menggunakan metode IVssWMFiledesc::GetBackupTypeMask .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	vss.h