(vss.h) 的 IVssAsync::QueryStatus 方法

QueryStatus 方法查询异步操作的状态。

语法

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

参数

[out] pHrResult

返回当前 IVssAsync 对象的异步操作的状态。

所有 IVssAsync 对象的所有 QueryStatus 调用都支持以下状态代码。

含义
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
标头 vss.h
Library VssApi.lib

另请参阅

IVssAsync

IVssBackupComponents::D oSnapshotSet

IVssBackupComponents::GatherWriterMetadata

IVssBackupComponents::GatherWriterStatus

IVssBackupComponents::ImportSnapshots

IVssBackupComponents::P ostRestore

IVssBackupComponents::P reRestore

IVssBackupComponents::P repareForBackup