Поделиться через


Функция ShouldBlockRevert (vsbackup.h)

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

Примечание Эта функция доступна только в операционных системах Windows Server.

 

Синтаксис

HRESULT ShouldBlockRevert(
  [in]  LPCWSTR wszVolumeName,
  [out] bool    *pbBlock
);

Параметры

[in] wszVolumeName

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

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

[out] pbBlock

Указатель на переменную, которая получает значение true, если том содержит компоненты из всех модулей записи, перечисленных в реестре как записи, которые должны блокировать операции отменить изменения, или false в противном случае.

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

Эта функция может возвращать одно из этих значений.

Значение Значение
S_OK
Функция выполнена успешно.
E_ACCESSDENIED
Вызывающий объект не является администратором.
E_INVALIDARG
Одно из значений параметра является недопустимым.
E_OUTOFMEMORY
Вызывающий объект не имеет памяти или других системных ресурсов.
VSS_E_UNEXPECTED
Непредвиденная ошибка. Код ошибки регистрируется в файле журнала ошибок. Дополнительные сведения см. в разделе Обработка событий и ошибок в VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP: Это значение не поддерживается до Windows Server 2008 R2 и Windows 7. вместо этого используется E_UNEXPECTED.

Комментарии

Список модулей записи, которые должны блокировать операции отменить изменения, хранится в реестре в следующем разделе:

HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\VSS\Settings\WritersBlockingRevert

Требования

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