Функция IsVolumeSnapshottedInternal (vsbackup.h)
Функция IsVolumeSnapshotted определяет, существуют ли какие-либо теневые копии для указанного тома.
Синтаксис
HRESULT IsVolumeSnapshottedInternal(
[in] VSS_PWSZ pwszVolumeName,
[out] BOOL *pbSnapshotsPresent,
[out] LONG *plSnapshotCapability
);
Параметры
[in] pwszVolumeName
Имя тома. Имя проверяемого тома должно быть в одном из следующих форматов и содержать обратную косую черту в конце (\):
- Путь к подключенной папке, например Y:\MountX\
- Буква диска, например D:\
- Путь GUID тома в формате \\?\Volume{GUID}\ (где GUID идентифицирует том)
[out] pbSnapshotsPresent
Значение этого параметра равно TRUE , если том имеет теневое копирование, и FALSE , если том не имеет теневой копии.
[out] plSnapshotCapability
Битовая маска (или побитовая или) значений VSS_SNAPSHOT_COMPATIBILITY , которая указывает, отключены ли определенные операции управления громкостью или файлового ввода-вывода для данного тома, если существует теневая копия.
Возвращаемое значение
Возвращаемые значения, перечисленные здесь, являются дополнением к обычным com HRESULTs, которые могут быть возвращены в любое время из функции.
Значение | Значение |
---|---|
|
Функция успешно завершена. |
|
Вызывающий объект не имеет достаточных прав на резервное копирование или не является администратором. |
|
Один из параметров недопустим. |
|
Нехватка памяти или других системных ресурсов. |
|
Ожидаемая ошибка поставщика. Поставщик зарегистрировал ошибку в журнале событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. |
|
Указанный том не найден. |
|
Непредвиденная ошибка. Код ошибки регистрируется в файле журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED. |
|
Непредвиденная ошибка поставщика. Код ошибки регистрируется в файле журнала событий. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS. |
Комментарии
Перед вызовом этой функции вызывающий объект должен инициализировать COM, вызвав функцию CoInitialize .
Если для выбранного тома не отключены операции управления громкостью или файлового ввода-вывода, то возможность теневого копирования выбранного тома, возвращаемого plSnapshotCapability , будет равна нулю.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | vsbackup.h (включая VsBackup.h, Vss.h, VsWriter.h) |
Библиотека | VssApi.lib |
DLL | VssApi.dll |