Метод IVssBackupComponents::ExposeSnapshot (vsbackup.h)

Статья
03/08/2023

Метод ExposeSnapshot предоставляет теневой копии в виде буквы диска, подключенной папки или общей папки.

Синтаксис

HRESULT ExposeSnapshot(
  [in]  VSS_ID   SnapshotId,
  [in]  VSS_PWSZ wszPathFromRoot,
  [in]  LONG     lAttributes,
  [in]  VSS_PWSZ wszExpose,
  [out] VSS_PWSZ *pwszExposed
);

Параметры

[in] SnapshotId

Идентификатор теневого копирования.

[in] wszPathFromRoot

Путь к части тома, доступной при предоставлении теневой копии в качестве общей папки. Значение этого параметра должно иметь значение NULL при локальном предоставлении теневой копии; то есть предоставление его в виде буквы диска или подключенной папки.

Путь не может содержать переменные среды (например, %MyEnv%) или подстановочные знаки.

Не требуется, чтобы путь заканчивалась обратной косой чертой (""). Только приложения, которые извлекают эти сведения в проверка.

[in] lAttributes

Атрибуты предоставленной теневой копии, указывающие, предоставляется ли она локально или удаленно. Значение должно быть либо VSS_VOLSNAP_ATTR_EXPOSED_LOCALLY , либо VSS_VOLSNAP_ATTR_EXPOSED_REMOTELYзначением _VSS_VOLUME_SNAPSHOT_ATTRIBUTES.

[in] wszExpose

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

[out] pwszExposed

Предоставленное имя теневой копии. Это либо имя общего ресурса, буква диска, за которой следует двоеточие, либо подключенная папка. Значение равно NULL , если сбой ExposeSnapshot . VSS выделяет память для этой строки.

Возвращаемое значение

Ниже приведены допустимые коды возврата для этого метода.

Значение	Значение
S_OK	Теневые копии были успешно предоставлены.
E_ACCESSDENIED	Вызывающий объект не имеет достаточных прав на резервное копирование или не является администратором.
E_INVALIDARG	Одно из значений параметра недопустимо.
E_OUTOFMEMORY	У вызывающего объекта не хватает памяти или других системных ресурсов.
VSS_E_BAD_STATE	Объект компонентов резервного копирования не инициализирован, этот метод был вызван во время операции восстановления или этот метод не был вызван в правильной последовательности.
VSS_E_OBJECT_NOT_FOUND	Указанная теневая копия не существует.
VSS_E_PROVIDER_VETO	Ожидаемая ошибка поставщика. Поставщик зарегистрировал ошибку в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
VSS_E_UNEXPECTED	Непредвиденная ошибка. Код ошибки записывается в файл журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED.
VSS_E_UNEXPECTED_PROVIDER_ERROR	Непредвиденная ошибка поставщика. Код ошибки регистрируется в журнале ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.

При предоставлении теневой копии тома теневая копия может рассматриваться как подключаемое устройство или как файловая система, доступная для общего доступа к файлам.

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

При использовании в качестве общей папки можно совместно использовать подмножества тома (обозначенные wszPathFromRoot).

Дополнительные сведения о том, как предоставлять теневые копии, см. в разделе Предоставление и отображение теневых копируемых томов.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	vsbackup.h (включая VsBackup.h, Vss.h, VsWriter.h)
Библиотека	VssApi.lib

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

IVssBackupComponents

IVssBackupComponents::ImportSnapshots

IVssBackupComponentsEx2::UnexposeSnapshot

VSS_PWSZ

_VSS_VOLUME_SNAPSHOT_ATTRIBUTES