перечисление VSS_FILE_SPEC_BACKUP_TYPE (vss.h)

Статья
03/13/2024

Перечисление VSS_FILE_SPEC_BACKUP_TYPE используется модулями записи для указания поддержки определенных операций резервного копирования, таких как добавочное или разностное резервное копирование, на основе наборов файлов (указанных файлов).

Наборы файлов, хранящиеся в документе метаданных модуля записи, помечаются битовой маской (или побитовой или) VSS_FILE_SPEC_BACKUP_TYPE значениями, указывающими на следующее:

Должен ли модуль записи и инициатор запроса оценивать заданный набор файлов для участия в указанных типах операций резервного копирования.
Требуется ли для резервного копирования указанного файла теневое копирование

Синтаксис

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;

Константы


`VSS_FSBT_FULL_BACKUP_REQUIRED` Значение: 0x1 Набор файлов, помеченный этим значением, должен участвовать во всех типах операций резервного копирования. Модуль записи помегивает набор файлов этим значением, чтобы указать инициатору запроса, что он ожидает копию текущего версия набора файлов, доступная после восстановления любой операции резервного копирования с помощью VSS_BACKUP_TYPE VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_BACKUP_REQUIRED` Значение: 0x2 Модуль записи помегивает набор файлов этим значением, чтобы указать инициатору запроса, что он ожидает копию текущего версия набора файлов, доступная после восстановления любой операции резервного копирования с помощью VSS_BACKUP_TYPE VSS_BT_DIFFERENTIAL. Это значение не поддерживается для экспресс-модулей записи.
`VSS_FSBT_INCREMENTAL_BACKUP_REQUIRED` Значение: 0x4 Модуль записи помегивает набор файлов этим значением, чтобы указать инициатору запроса, что он ожидает копию текущего версия набора файлов, доступная после восстановления любой операции резервного копирования с помощью VSS_BACKUP_TYPE VSS_BT_INCREMENTAL. Это значение не поддерживается для экспресс-модулей записи.
`VSS_FSBT_LOG_BACKUP_REQUIRED` Значение: 0x8 Модуль записи помегивает набор файлов этим значением, чтобы указать инициатору запроса, что он ожидает копию текущего версия набора файлов, доступная после восстановления любой операции резервного копирования с помощью VSS_BACKUP_TYPE VSS_BT_LOG. Это значение не поддерживается для экспресс-модулей записи.
`VSS_FSBT_FULL_SNAPSHOT_REQUIRED` Значение: 0x100 Для набора файлов, помеченного этим значением, необходимо создать резервную копию из теневой копии тома (а не из исходный том) при участии в операции резервного копирования с помощью VSS_BACKUP_TYPE VSS_BT_FULL.
`VSS_FSBT_DIFFERENTIAL_SNAPSHOT_REQUIRED` Значение: 0x200 Для набора файлов, помеченного этим значением, необходимо создать резервную копию из теневой копии тома (а не из исходный том) при участии в операции резервного копирования с помощью VSS_BACKUP_TYPE VSS_BT_DIFFERENTIAL.
`VSS_FSBT_INCREMENTAL_SNAPSHOT_REQUIRED` Значение: 0x400 Для набора файлов, помеченного этим значением, необходимо создать резервную копию из теневой копии тома (а не из исходный том) при участии в операции резервного копирования с помощью VSS_BACKUP_TYPE VSS_BT_INCREMENTAL.
`VSS_FSBT_LOG_SNAPSHOT_REQUIRED` Значение: 0x800 Для набора файлов, помеченного этим значением, необходимо создать резервную копию из теневой копии тома (а не из исходный том) при участии в операции резервного копирования с помощью VSS_BACKUP_TYPE VSS_BT_LOG).
`VSS_FSBT_CREATED_DURING_BACKUP` Значение: 0x10000 Модуль записи помеет набор файлов этим значением, чтобы указать инициатору запроса, что он ожидает, что файл будет создан во время snapshot последовательности.
`VSS_FSBT_ALL_BACKUP_REQUIRED` Значение: 0xf Тип спецификации резервного копирования файлов по умолчанию. Набор файлов, помеченный этим значением, всегда должен участвовать в операции резервного копирования и восстановления.
`VSS_FSBT_ALL_SNAPSHOT_REQUIRED` Значение: 0xf00 Требование теневой копии для резервного копирования. Набор файлов, помеченный этим значением, всегда должен выполнять резервное копирование из теневая копия тома (и никогда из исходного тома) при участии в операции резервного копирования.

Когда модуль записи задает необходимое для резервного копирования значение перечисления VSS_FILE_SPEC_BACKUP_TYPE , это означает, что инициатор запроса выполняет резервное копирование таким образом, что при восстановлении резервной копии восстанавливается текущая версия набора файлов. Как правило, это означает, что набор файлов копируется как часть резервной копии.

Этот параметр можно переопределить, если файл добавляется в документ компонентов резервного копирования в виде разностного файла (с помощью IVssComponent::AddDifferencedFilesByLastModifyTime) или в виде частичного файла (с использованием IVssComponent::AddPartialFile).

Если файл добавляется в виде разностного файла, модуль записи устанавливает критерии, по которым инициатор запроса должен решить, следует ли копировать файл на носитель резервного копирования. Модуль записи обычно добавляет разностные файлы в документ компонентов резервной копии для включения в резервное событие PostSnapshot (см. CVssWriter::OnPostSnapshot). Дополнительные сведения см. в разделе Добавочные и разностные резервные копии .

Когда модуль записи задает необходимое для теневого копирования значение перечисления VSS_FILE_SPEC_BACKUP_TYPE , это означает, что для набора файлов необходимо создать резервную копию из тома с теневым копированием. Наборы файлов, не помеченные теневым значением, необходимым для копирования, можно создать резервную копию из исходного тома.

Записи задают VSS_FILE_SPEC_BACKUP_TYPE значения при обработке события Identify (см. раздел CVssWriter::OnIdentify).

Битовую маску (или побитовую) значения VSS_FILE_SPEC_BACKUP_TYPE можно применить к набору файлов при добавлении его в компонент с помощью метода IVssCreateWriterMetadata::AddFilesToFileGroup, IVssCreateWriterMetadata::AddDatabaseFiles или IVssCreateWriterMetadata::AddDatabaseLogFiles .

Если при добавлении спецификации файла к компоненту не указан явный тип резервного копирования спецификации файла, спецификация помечается значением VSS_FILE_SPEC_BACKUP_TYPE по умолчанию: (VSS_FSBT_ALL_BACKUP_REQUIRED | VSS_FSBT_ALL_SNAPSHOT_REQUIRED).

Инициаторы запроса или записи могут восстановить тип резервной копии спецификации файлового набора с помощью метода IVssWMFiledesc::GetBackupTypeMask .

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	vss.h