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


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

Позволяет указать дополнительные атрибуты для теневой копии. Контекст теневой копии (заданный методом 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 — VSS_CTX_BACKUP.

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

Инициаторы запроса могут изменить этот контекст с помощью побитового или значения _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

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

IVssBackupComponents::D eleteSnapshots

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::ExposeSnapshot

IVssBackupComponents::GetSnapshotProperties

IVssBackupComponents::ImportSnapshots

IVssBackupComponents::SetContext

VSS_OBJECT_PROP

VSS_SNAPSHOT_PROP

_VSS_SNAPSHOT_CONTEXT