Поделиться через

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

  • Статья

Перечисление _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_SNAPSHOT_CONTEXT , — LONG.

Контекст по умолчанию для теневых копий VSS — VSS_CTX_BACKUP.

Windows XP: Единственным поддерживаемым контекстом является контекст по умолчанию , VSS_CTX_BACKUP. Вызов метода IVssBackupComponents::SetContext вернет E_NOTIMPL.

Дополнительные сведения об использовании контекстов теневых копий VSS см. в разделе Сведения о реализации для создания теневых копий.

Поведение теневого копирования можно дополнительно контролировать с помощью побитового или для объединения поддерживаемого _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

См. также раздел

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::SetContext

VSS_OBJECT_PROP

VSS_SNAPSHOT_PROP

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES