Share via

Метод IVssSoftwareSnapshotProvider::IsVolumeSupported (vsprov.h)

  • Статья

Определяет, поддерживает ли поставщик теневые копии на указанном томе.

Синтаксис

HRESULT IsVolumeSupported(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSupportedByThisProvider
);

Параметры

[in] pwszVolumeName

Строка расширенных символов, завершающаяся null, содержащая имя тома. Имя должно иметь один из следующих форматов и включать в себя обратную косую черту в конце (\):

  • Путь к подключенной папке, например Y:\MountX\
  • Буква диска, например D:\
  • Путь GUID тома в формате \\?\Volume{GUID}\ (где GUID идентифицирует том)

[out] pbSupportedByThisProvider

Этот параметр получает значение TRUE , если на указанном томе поддерживаются теневые копии, в противном случае — ЗНАЧЕНИЕ FALSE.

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

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

Значение Значение
S_OK
 Запрошенные сведения были успешно возвращены.
E_ACCESSDENIED
 Вызывающий объект не имеет достаточных прав на резервное копирование или не является администратором.
E_INVALIDARG
 Одно из значений параметра недопустимо.
VSS_E_NESTED_VOLUME_LIMIT
 Указанный том слишком глубоко вложен для участия в операции VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Этот код возврата не поддерживается.
E_OUTOFMEMORY
 У вызывающего объекта не хватает памяти или других системных ресурсов.
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.

Комментарии

Метод IsVolumeSupported возвращает значение TRUE , если можно создать теневые копии на данном томе, даже если текущая конфигурация в настоящее время не позволяет создавать теневые копии на этом томе.

Например, если достигнуто максимальное число теневых копий для данного тома (и, следовательно, на этом томе невозможно создать больше теневых копий), метод по-прежнему будет указывать, что том можно копировать теневыми копиями.

Этот метод не может быть вызван для виртуального жесткого диска (VHD), вложенного в другой виртуальный жесткий диск.

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Виртуальные жесткие диски не поддерживаются.

Требования

   
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header vsprov.h
Библиотека VssApi.lib

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

IVssSoftwareSnapshotProvider