Метод IVssAsync::QueryStatus (vss.h)

Метод QueryStatus запрашивает состояние асинхронной операции.

Синтаксис

HRESULT QueryStatus(
  [out] HRESULT *pHrResult,
  [out] INT     *pReserved
);

Параметры

[out] pHrResult

Состояние асинхронной операции, возвращающей текущий объект IVssAsync .

Все вызовы QueryStatus для всех объектов IVssAsync поддерживают следующие коды состояния.

Значение Значение
VSS_S_ASYNC_CANCELLED
Асинхронная операция была отменена предыдущим вызовом IVssAsync::Cancel.
VSS_S_ASYNC_FINISHED
Асинхронная операция успешно завершена.
VSS_S_ASYNC_PENDING
Асинхронная операция по-прежнему выполняется.
 

Можно возвращать дополнительные возвращаемые значения, но они зависят от кодов возврата метода, который изначально возвращал объект IVssAsync .

[out] pReserved

Значение этого параметра должно иметь значение NULL.

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

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

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

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

Комментарии

В случае ошибки во время асинхронной операции QueryStatus вернет тот же код ошибки, что и метод, который изначально возвращал объект IVssAsync .

Чтобы получить полный список возвращаемых значений для объекта IVssAsync::QueryStatus , возвращаемого определенным методом, см. коды ошибок, задокументированные для этого метода.

Требования

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

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

IVssAsync

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::GatherWriterMetadata

IVssBackupComponents::GatherWriterStatus

IVssBackupComponents::ImportSnapshots

IVssBackupComponents::P ostRestore

IVssBackupComponents::P reRestore

IVssBackupComponents::P repareForBackup