структура VSS_SNAPSHOT_PROP (vss.h)

Статья
03/13/2024

Структура VSS_SNAPSHOT_PROP содержит свойства теневой копии или набора теневого копирования.

Синтаксис

typedef struct _VSS_SNAPSHOT_PROP {
  VSS_ID             m_SnapshotId;
  VSS_ID             m_SnapshotSetId;
  LONG               m_lSnapshotsCount;
  VSS_PWSZ           m_pwszSnapshotDeviceObject;
  VSS_PWSZ           m_pwszOriginalVolumeName;
  VSS_PWSZ           m_pwszOriginatingMachine;
  VSS_PWSZ           m_pwszServiceMachine;
  VSS_PWSZ           m_pwszExposedName;
  VSS_PWSZ           m_pwszExposedPath;
  VSS_ID             m_ProviderId;
  LONG               m_lSnapshotAttributes;
  VSS_TIMESTAMP      m_tsCreationTimestamp;
  VSS_SNAPSHOT_STATE m_eStatus;
} VSS_SNAPSHOT_PROP, *PVSS_SNAPSHOT_PROP;

Члены

m_SnapshotId

VSS_ID (GUID), однозначно определяющий идентификатор теневого копирования.

m_SnapshotSetId

VSS_ID (GUID), однозначно определяющий набор теневых копий, содержащий теневое копирование.

m_lSnapshotsCount

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

Максимальное число теневых томов, разрешенных в наборе теневого копирования, составляет 64.

m_pwszSnapshotDeviceObject

Строка расширенных символов со значением NULL, содержащая имя объекта устройства для теневой копии тома. Объект устройства можно рассматривать как корень теневой копии тома. Инициаторы запроса будут использовать это имя устройства при доступе к файлам на теневых томах, с которыми необходимо работать.

Имя устройства не содержит символа "".

m_pwszOriginalVolumeName

Строка расширенных символов с завершением NULL, содержащая имя тома, скопированного тенью.

m_pwszOriginatingMachine

Строка расширенных символов со значением NULL, содержащая имя компьютера, содержащего исходный том.

m_pwszServiceMachine

Строка расширенных символов со значением NULL, содержащая имя компьютера, на котором запущена служба теневого копирования томов, создавшего теневое копирование.

m_pwszExposedName

Строка расширенных символов, заканчивающаяся null, которая содержит имя теневой копии, когда она предоставляется. Это буква диска или подключенная папка (если теневая копия предоставляется в виде локального тома) или имя общей папки. Соответствует параметру wszExpose метода IVssBackupComponents::ExposeSnapshot .

m_pwszExposedPath

Строка расширенных символов, заканчивающаяся null, указывающая, какая часть теневой копии тома становится доступной, если она предоставляется в качестве общей папки. Соответствует параметру wszPathFromRoot метода IVssBackupComponents::ExposeSnapshot .

m_ProviderId

VSS_ID (GUID), однозначно идентифицирующие поставщика, используемого для создания этой теневой копии.

m_lSnapshotAttributes

Атрибуты теневой копии, выраженные в виде битовой маски (или побитовой или) членов перечисления _VSS_VOLUME_SNAPSHOT_ATTRIBUTES .

m_tsCreationTimestamp

Метка времени, указывающая, когда была создана теневая копия. Точное время определяется поставщиком. Сведения о формате метки времени см. в VSS_TIMESTAMP .

m_eStatus

Текущее состояние создания теневой копии. См . VSS_SNAPSHOT_STATE.

Инициаторы запроса обычно получают указатель на структуру VSS_SNAPSHOT_PROP с помощью метода IVssBackupComponents::GetSnapshotProperties или метода IVssSoftwareSnapshotProvider::GetSnapshotProperties . Если эта структура больше не нужна, вызывающий объект отвечает за ее освобождение с помощью функции VssFreeSnapshotProperties .

Объект устройства теневого копирования, содержащийся в m_pwszSnapshotDeviceObject , используется для обращения к файлам в теневой копии тома. Например, если исходный том содержит файл с путем "\topleveldir\File.html", то путь к теневой копии файла — "m_pwszSnapshotDeviceObject"+"\topleveldir\File.html".

Если теневая копия предоставляется в качестве общей папки, значением m_pwszExposedName будет имя общей папки. Если теневая копия предоставляется в виде буквы диска или подключенной папки, теневая копия m_pwszExposedName представляет собой букву диска, за которой следует двоеточие, например "X:" или подключенный путь к папке (например, "Y:\MountX").

Если теневая копия предоставляется в виде буквы диска или подключенной папки, то (как и при подключении любого устройства) вся теневая копия, начиная с ее корня, будет доступна в точке подключения. В этом случае m_pwszExposedPath будет иметь значение NULL.

Если теневая копия предоставляется в качестве общей папки, значением m_pwszExposedPath будет путь к той части тома, к которой предоставлен общий доступ.

Требования

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