IVssSoftwareSnapshotProvider::QueryRevertStatus 方法 (vsprov.h)

返回可用于确定还原作状态的 IVssAsync 接口指针。

Syntax

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

参数

[in] pwszVolume

包含卷名称的以 Null 结尾的宽字符字符串。 名称必须具有以下格式之一,并且必须包含尾部反斜杠(\):

  • 已装载文件夹的路径,例如 Y:\MountX\
  • 驱动器号,例如 D:\
  • 格式为 \\?\Volume{GUID}\ 的卷 GUID 路径(其中 GUID 标识卷)

[out] ppAsync

指向将接收 IVssAsync 接口指针的位置的指针,该指针可用于检索还原作的状态。 作完成后,调用方必须通过调用 IUnknown::Release 方法释放接口指针。

返回值

下面是此方法的有效返回代码。

价值 Meaning
S_OK
已成功查询还原作的状态。
E_ACCESSDENIED
调用方没有足够的备份权限,或者不是管理员。
E_INVALIDARG
其中一个参数值无效。
E_OUTOFMEMORY
调用方内存不足或其他系统资源。
VSS_E_OBJECT_NOT_FOUND
pwszVolume 参数未指定有效的卷。
VSS_E_VOLUME_NOT_SUPPORTED
此卷不支持还原作。

注解

即使计算机重新启动并且无法取消或撤消还原作,还原作也会继续,除非还原使用另一种方法创建的备份。 IVssAsync::QueryStatus 方法无法返回VSS_S_ASYNC_CANCELLED,因为还原作在启动后无法取消。

要求

Requirement 价值
最低支持的客户端 Windows Vista [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows操作系统
Header vsprov.h
Library VssApi.lib

另请参阅

IVssSoftwareSnapshotProvider