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

Статья
03/13/2024

Перечисление _VSS_SNAPSHOT_CONTEXT позволяет инициатору запроса, использующим IVssBackupComponents::SetContext , указать способ создания, запроса или удаления теневой копии, а также степень участия модуля записи.

Синтаксис

typedef enum _VSS_SNAPSHOT_CONTEXT {
  VSS_CTX_BACKUP = 0,
  VSS_CTX_FILE_SHARE_BACKUP,
  VSS_CTX_NAS_ROLLBACK,
  VSS_CTX_APP_ROLLBACK,
  VSS_CTX_CLIENT_ACCESSIBLE,
  VSS_CTX_CLIENT_ACCESSIBLE_WRITERS,
  VSS_CTX_ALL = 0xffffffff
} VSS_SNAPSHOT_CONTEXT, *PVSS_SNAPSHOT_CONTEXT;

Константы


`VSS_CTX_BACKUP` Значение: 0 Стандартный контекст резервного копирования. Указывает теневые копии с автоматическим освобождением, в которой находятся записи. участвует в создании.
`VSS_CTX_FILE_SHARE_BACKUP` Указывает теневые копии с автоматическим освобождением, созданные без участия модуля записи.
`VSS_CTX_NAS_ROLLBACK` Указывает постоянную теневое копирование без автоматического освобождения без участия модуля записи. Этот контекст должен быть используется, когда нет необходимости в участии в записи, чтобы убедиться, что файлы находятся в согласованном состоянии в то время теневой копии. Упрощенные механизмы автоматического отката файлов или постоянные теневые копии общих папок или томов данных В этом контексте могут выполняться файлы или базы данных, которые не должны содержать какие-либо системные файлы или базы данных. Для Например, инициатор запроса может использовать этот контекст для создания теневой копии тома NAS, в котором размещаются документы и простые пользовательские общие папки. Эти типы данных не требуют участия модуля записи для создания согласованной теневой копии.
`VSS_CTX_APP_ROLLBACK` Указывает постоянную теневое копирование без автоматического освобождения с участием модуля записи. Этот контекст разработан для использования, когда необходимы записи, чтобы убедиться, что файлы находятся в четко определенном состоянии перед теневым копированием. Автоматизированные механизмы отката файлов системных томов и теневых копий для использования в интеллектуальном анализе или восстановлении данных Операции могут выполняться в этом контексте. Этот контекст аналогичен VSS_CTX_BACKUP но позволяет инициатору запроса больше контролировать сохраняемость теневой копии.
`VSS_CTX_CLIENT_ACCESSIBLE` Указывает теневые копии только для чтения, доступные клиенту , которые поддерживают теневые копии общих папок и создаются без участия модуля записи. Этот тип теневой копии может создавать только системный поставщик (поставщик по умолчанию, доступный в системе). Большинство инициаторов запроса хотят использовать контекст VSS_CTX_NAS_ROLLBACK для постоянных теневых копий без автоматического освобождения без участия модуля записи.
`VSS_CTX_CLIENT_ACCESSIBLE_WRITERS` Указывает теневые копии только для чтения, доступные клиенту , которые создаются с участием модуля записи. Этот тип теневой копии может создавать только системный поставщик (поставщик по умолчанию, доступный в системе). Большинству инициаторов запросов потребуется использовать контекст VSS_CTX_APP_ROLLBACK для постоянных теневых копий без автоматического освобождения с участием модуля записи. Windows Server 2003 и Windows XP: Этот контекст не поддерживается Windows Server 2003 и Windows XP.
`VSS_CTX_ALL` Значение: 0xffffffff Все типы текущих теневых копий доступны для административных операций, таких как теневое копирование. запросы (см. раздел IVssBackupComponents::Query). VSS_CTX_ALL является допустимым контекстом для всех интерфейсов VSS, кроме IVssBackupComponents::StartSnapshotSet и IVssBackupComponents::D oSnapshotSet.

Поведение теневого копирования можно дополнительно контролировать с помощью побитового или для объединения поддерживаемого _VSS_VOLUME_SNAPSHOT_ATTRIBUTES с допустимыми значениями _VSS_SNAPSHOT_CONTEXT в качестве аргумента метода IVssBackupComponents::SetContext .

В настоящее время единственными поддерживаемыми изменениями являются побитовое ИЛИ _VSS_SNAPSHOT_CONTEXT значения с VSS_VOLSNAP_ATTR_TRANSPORTABLE и либо VSS_VOLSNAP_ATTR_DIFFERENTIAL , либо значение VSS_VOLSNAP_ATTR_PLEX перечисления _VSS_VOLUME_SNAPSHOT_ATTRIBUTES .

Однако эти значения нельзя использовать для изменения VSS_CTX_CLIENT_ACCESSIBLE контекста.

Использование VSS_VOLSNAP_ATTR_TRANSPORTABLE ограничено системами под управлением Windows Server 2008 Корпоративная, Windows Server 2008 Datacenter, Windows Server 2003, выпуск Enterprise или Windows Server 2003, Datacenter Edition.

Требования

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