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

  • Статья

Метод QueryRevertStatus возвращает указатель интерфейса IVssAsync, который можно использовать для определения состояния операции отменить изменения.

Синтаксис

HRESULT QueryRevertStatus(
  [in]  VSS_PWSZ  pwszVolume,
  [out] IVssAsync **ppAsync
);

Параметры

[in] pwszVolume

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

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

[out] ppAsync

Указатель на расположение, которое получит указатель интерфейса IVssAsync, который можно использовать для получения состояния процесса отменить изменения. После завершения операции вызывающий объект должен освободить указатель интерфейса, вызвав метод IUnknown::Release .

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

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

Значение Значение
S_OK
 Операция выполнена успешно.
E_ACCESSDENIED
 У вызывающего процесса недостаточно привилегий.
E_FAIL
 Произошла внутренняя ошибка.
E_INVALIDARG
 Один из переданных параметров недопустим.
E_NOTIMPL
 Поставщик тома не поддерживает операции отменить изменения.
E_OUTOFMEMORY
 Вызывающий объект не имеет памяти или других системных ресурсов.
E_POINTER
 Один из обязательных параметров указателя — NULL.
VSS_E_OBJECT_NOT_FOUND
 Параметр pwszVolume не является допустимым томом.
VSS_E_VOLUME_NOT_SUPPORTED
 Восстановление не поддерживается на этом томе.

Комментарии

Операция отменить изменения будет продолжена, даже если компьютер перезагружается, и ее нельзя отменить или отменить, за исключением восстановления резервной копии, созданной с помощью другого метода. Метод QueryStatus для возвращаемого
Интерфейс IVssAsync не может вернуть VSS_S_ASYNC_CANCELLED, так как операция отменить изменения не может быть отменена после ее запуска.

Требования

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

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

IVssAsync

IVssBackupComponents

IVssBackupComponents::RevertToSnapshot