IVssBackupComponents::QueryRevertStatus 方法 (vsbackup.h)

QueryRevertStatus 方法返回可用于确定还原作状态的 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_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 ,因为还原作在启动后无法取消。

要求

Requirement 价值
最低支持的客户端 Windows Vista SP1 [仅限桌面应用]
支持的最低服务器 具有 SP1 的 Windows Server 2008、Windows Server 2003 [仅限桌面应用]
目标平台 Windows操作系统
Header vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h)
Library VssApi.lib

另请参阅

IVssAsync

IVssBackupComponents

IVssBackupComponents::RevertToSnapshot