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

Статья
08/27/2023

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

Синтаксис

typedef enum _VSS_VOLUME_SNAPSHOT_ATTRIBUTES {
  VSS_VOLSNAP_ATTR_PERSISTENT = 0x1,
  VSS_VOLSNAP_ATTR_NO_AUTORECOVERY = 0x2,
  VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE = 0x4,
  VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE = 0x8,
  VSS_VOLSNAP_ATTR_NO_WRITERS = 0x10,
  VSS_VOLSNAP_ATTR_TRANSPORTABLE = 0x20,
  VSS_VOLSNAP_ATTR_NOT_SURFACED = 0x40,
  VSS_VOLSNAP_ATTR_NOT_TRANSACTED = 0x80,
  VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED = 0x10000,
  VSS_VOLSNAP_ATTR_DIFFERENTIAL = 0x20000,
  VSS_VOLSNAP_ATTR_PLEX = 0x40000,
  VSS_VOLSNAP_ATTR_IMPORTED = 0x80000,
  VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY = 0x100000,
  VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY = 0x200000,
  VSS_VOLSNAP_ATTR_AUTORECOVER = 0x400000,
  VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY = 0x800000,
  VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT = 0x1000000,
  VSS_VOLSNAP_ATTR_TXF_RECOVERY = 0x2000000,
  VSS_VOLSNAP_ATTR_FILE_SHARE = 0x4000000
} VSS_VOLUME_SNAPSHOT_ATTRIBUTES, *PVSS_VOLUME_SNAPSHOT_ATTRIBUTES;

Константы


`VSS_VOLSNAP_ATTR_PERSISTENT` Значение: 0x1 Теневая копия сохраняется при перезагрузках. Этот атрибут автоматически устанавливается для _VSS_SNAPSHOT_CONTEXT контекстов VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS и VSS_CTX_NAS_ROLLBACK. Этот атрибут не должен использоваться явно инициаторами запроса при настройке контекста теневой копии.
`VSS_VOLSNAP_ATTR_NO_AUTORECOVERY` Значение: 0x2 Автоматическое восстановление отключено для теневой копии. Инициатор запроса может изменить контекст теневого копирования с помощью побитового ИЛИ этого атрибута. Таким образом, инициатор запроса указывает VSS сделать теневое копирование доступной только для чтения сразу после ее создания, не разрешая записи или другие приложения обновлять компоненты в теневой копии. Отключение автоматического восстановления может привести к тому, что теневая копия будет находиться в несогласованном состоянии, если какой-либо из ее компонентов участвует в транзакционных операциях базы данных, таких как операции чтения и записи транзакций, управляемые транзакционной NTFS (TxF). Это связано с тем, что отключение автоматического восстановления предотвращает откат неполных транзакций. Отключение автоматического восстановления также предотвращает исключение файлов из теневой копии. Если автоматическое восстановление отключено, модуль записи по-прежнему может вызывать метод IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot , но метод CVssWriter::OnPostSnapshot модуля записи не может удалить файлы из теневой копии. Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Vista.
`VSS_VOLSNAP_ATTR_CLIENT_ACCESSIBLE` Значение: 0x4 Указанная теневая копия является теневой копией, доступной клиентом , которая поддерживает теневые копии для общих папок и не должна быть предоставлена. Этот атрибут автоматически задается для VSS_CTX_CLIENT_ACCESSIBLE и VSS_CTX_CLIENT_ACCESSIBLE_WRITERS. Этот атрибут не должен использоваться явно инициаторами запроса при настройке контекста теневой копии.
`VSS_VOLSNAP_ATTR_NO_AUTO_RELEASE` Значение: 0x8 Теневая копия не удаляется автоматически после завершения процесса инициатора запроса теневого копирования. Теневая копия может быть удален только при вызове IVssBackupComponents::D eleteSnapshots. Этот атрибут автоматически устанавливается для _VSS_SNAPSHOT_CONTEXT контекстов VSS_CTX_APP_ROLLBACK, VSS_CTX_CLIENT_ACCESSIBLE, VSS_CTX_CLIENT_ACCESSIBLE_WRITERS и VSS_CTX_NAS_ROLLBACK. Этот атрибут не должен использоваться явно инициаторами запроса при настройке контекста теневой копии.
`VSS_VOLSNAP_ATTR_NO_WRITERS` Значение: 0x10 В создании теневой копии не участвуют средства записи. Этот атрибут автоматически устанавливается для _VSS_SNAPSHOT_CONTEXT контекстов VSS_CTX_NAS_ROLLBACK, VSS_CTX_FILE_SHARE_BACKUP и VSS_CTX_CLIENT_ACCESSIBLE. Этот атрибут не должен использоваться явно инициаторами запроса при настройке контекста теневой копии.
`VSS_VOLSNAP_ATTR_TRANSPORTABLE` Значение: 0x20 Теневая копия должна быть транспортирована и поэтому не должна отображаться локально. Этот атрибут может явно использоваться инициаторами запроса при настройке контекста теневой копии, если Поставщик теневого копирования поддерживает переносимые теневые копии. Windows Server 2003, Standard Edition, Windows Server 2003, Web Edition и Windows XP: Этот атрибут не поддерживается. Все выпуски Windows Server 2003 с пакетом обновления 1 (SP1) поддерживают этот атрибут. См. раздел Импорт транспорта Дополнительные сведения см. в статье Теневое копирование томов .
`VSS_VOLSNAP_ATTR_NOT_SURFACED` Значение: 0x40 Теневая копия в настоящее время не предоставляется. Если теневая копия не предоставляется или не подключена явным образом, этот атрибут устанавливается для всех теневых копий. Этот атрибут не должен использоваться явно инициаторами запроса при настройке контекста теневой копии.
`VSS_VOLSNAP_ATTR_NOT_TRANSACTED` Значение: 0x80 Теневая копия не выполняется. Инициатор запроса может изменить контекст теневого копирования с помощью побитового ИЛИ этого атрибута. Таким образом, инициатор запроса указывает VSS отключить встроенную интеграцию между VSS и диспетчерами транзакций и ресурсов. Установка этого атрибута гарантирует, что инициатор запроса не получит VSS_E_TRANSACTION_FREEZE_TIMEOUT ошибок. Однако это может привести к нежелательным последствиям, таким как потеря целостности транзакций или даже потеря данных. Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Vista.
`VSS_VOLSNAP_ATTR_HARDWARE_ASSISTED` Значение: 0x10000 Указывает, что данный поставщик является поставщиком оборудования. Этот атрибут автоматически устанавливается для поставщиков оборудования. Это значение перечисления не может использоваться для установки контекста вручную (с помощью IVssBackupComponents::SetContext метод) теневой копии битовой маской (или битовой или) этого значения перечисления и допустимой теневой копией значение контекста из _VSS_SNAPSHOT_CONTEXT.
`VSS_VOLSNAP_ATTR_DIFFERENTIAL` Значение: 0x20000 Указывает, что данный поставщик использует разностные данные или механизм копирования при записи для реализации теневых копий. Инициатор запроса может изменить контекст теневого копирования с помощью побитового ИЛИ этого атрибута. Таким образом, Инициатор запроса предписывает поставщикам создать теневое копирование с помощью разностной реализации. Если теневая копия отсутствует Поставщик, установленный в системе, поддерживает запрошенные атрибуты, VSS_E_VOLUME_NOT_SUPPORTED ошибка будет возвращено в IVssBackupComponents::AddToSnapshotSet.
`VSS_VOLSNAP_ATTR_PLEX` Значение: 0x40000 Указывает, что данный поставщик использует механизм PLEX или зеркального разбиения для реализации теневых копий. Инициатор запроса может изменить контекст теневого копирования с помощью побитового ИЛИ этого атрибута. Таким образом, Инициатор запроса указывает поставщикам создать теневое копирование с помощью реализации PLEX. Если теневая копия отсутствует Поставщик, установленный в системе, поддерживает запрошенные атрибуты, VSS_E_VOLUME_NOT_SUPPORTED ошибка будет возвращено в IVssBackupComponents::AddToSnapshotSet.
`VSS_VOLSNAP_ATTR_IMPORTED` Значение: 0x80000 Теневая копия тома была импортирована на этот компьютер с помощью IVssBackupComponents::ImportSnapshots метод, а не созданный с помощью IVssBackupComponents::D oSnapshotSet метод. Этот атрибут устанавливается автоматически при импорте теневой копии. Этот атрибут не должен использоваться явно инициаторами запроса при настройке контекста теневой копии.
`VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY` Значение: 0x100000 Теневая копия предоставляется локально. Если этот флаг бита и флаг бита VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY имеют значение не задано, теневая копия скрыта. Атрибут автоматически добавляется в контекст теневого копирования при вызове IVssBackupComponents::ExposeSnapshot метод для локального предоставления теневой копии. Этот атрибут не должен использоваться явным образом инициаторами запроса при настройке контекста теневой копии.
`VSS_VOLSNAP_ATTR_EXPOSED_REMOTELY` Значение: 0x200000 Теневая копия предоставляется удаленно. Если этот флаг бита и флаг VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY бита имеют значение не задано, теневая копия скрыта. Атрибут автоматически добавляется в контекст теневого копирования при вызове IVssBackupComponents::ExposeSnapshot метод для локального предоставления теневой копии. Этот атрибут не должен использоваться явным образом инициаторами запроса при настройке контекста теневой копии.
`VSS_VOLSNAP_ATTR_AUTORECOVER` Значение: 0x400000 Указывает, что модулю записи потребуется автоматически восстановить компонент в CVssWriter::OnPostSnapshot. Этот атрибут не должен использоваться явным образом инициаторами запроса при настройке контекста теневой копии.
`VSS_VOLSNAP_ATTR_ROLLBACK_RECOVERY` Значение: 0x800000 Указывает, что средству записи потребуется автоматически восстановить компонент в CVssWriter::OnPostSnapshot , если теневая копия используется для отката (например, для интеллектуального анализа данных). Инициатор запроса устанавливает этот флаг в контексте теневого копирования, чтобы указать, что теневая копия создается для не резервного копирования, например для интеллектуального анализа данных.
`VSS_VOLSNAP_ATTR_DELAYED_POSTSNAPSHOT` Значение: 0x1000000 Зарезервировано для системного использования. Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008.
`VSS_VOLSNAP_ATTR_TXF_RECOVERY` Значение: 0x2000000 Указывает, что восстановление TxF должно быть принудительно применено во время создания теневой копии. Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008.
`VSS_VOLSNAP_ATTR_FILE_SHARE` Значение: 0x4000000

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

Поставщики могут использовать любой тип механизма для реализации теневой копии, если не было специально запрошено для поддержки определенного механизма. Таким образом, если метод теневого копирования не указан, поставщик может выбрать разностный механизм (VSS_VOLSNAP_ATTR_DIFFERENTIAL), механизм PLEX (VSS_VOLSNAP_ATTR_PLEX) или любой другой механизм для поддержки теневой копии.

Хотя поставщик может поддерживать оба механизма, они являются взаимоисключающими для данной теневой копии. Инициаторы запроса не должны использовать VSS_VOLSNAP_ATTR_DIFFERENTIAL и VSS_VOLSNAP_ATTR_PLEX для изменения определенного контекста теневого копирования.

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

Кроме того, его нельзя использовать для изменения контекста VSS_CTX_CLIENT_ACCESSIBLE .

Инициатор запроса может получить сведения о конкретной теневой копии (определяемой VSS_ID), распаковав структуру VSS_SNAPSHOT_PROP из структуры VSS_OBJECT_PROP , возвращаемой вызовом метода IVssBackupComponents::GetSnapshotProperties.

Инициатор запроса также может получить структуру VSS_SNAPSHOT_PROP для каждой из нескольких теневых копий, вызвав метод IVssBackupComponents::Query и используя IVssEnumObject для итерации возвращаемых данных.

Контекст и атрибуты теневых копий находятся в виде битовой маски, содержащейся в элементе m_lSnapshotAttributesструктуры VSS_SNAPSHOT_PROP .

Требования


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