Метод IVssBackupComponents::ExposeSnapshot (vsbackup.h)
Метод 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 выделяет память для этой строки.
Возвращаемое значение
Ниже приведены допустимые коды возврата для этого метода.
| Значение | Значение |
|---|---|
|
Теневые копии были успешно предоставлены. |
|
Вызывающий объект не имеет достаточных прав на резервное копирование или не является администратором. |
|
Одно из значений параметра недопустимо. |
|
У вызывающего объекта не хватает памяти или других системных ресурсов. |
|
Объект компонентов резервного копирования не инициализирован, этот метод был вызван во время операции восстановления или этот метод не был вызван в правильной последовательности. |
|
Указанная теневая копия не существует. |
|
Ожидаемая ошибка поставщика. Поставщик зарегистрировал ошибку в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. |
|
Непредвиденная ошибка. Код ошибки записывается в файл журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED. |
|
Непредвиденная ошибка поставщика. Код ошибки регистрируется в журнале ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. |
Комментарии
Вызывающий объект отвечает за освобождение строки, на которую указывает параметр pwsz Exposed , путем вызова функции CoTaskMemFree .
При предоставлении постоянной теневой копии она остается открытой при последующих загрузках.
При предоставлении теневой копии тома теневая копия может рассматриваться как подключаемое устройство или как файловая система, доступная для общего доступа к файлам.
Когда он предоставляется как устройство ( как и в случае с другими подключенными устройствами), теневая копия тома отображается в точке подключения (буква диска или подключенная папка), начиная с корневого каталога.
При использовании в качестве общей папки можно совместно использовать подмножества тома (обозначенные wszPathFromRoot).
Дополнительные сведения о том, как предоставлять теневые копии, см. в разделе Предоставление и отображение теневых копируемых томов.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | vsbackup.h (включая VsBackup.h, Vss.h, VsWriter.h) |
| Библиотека | VssApi.lib |
См. также раздел
IVssBackupComponents::ImportSnapshots