IVssBackupComponents::D oSnapshotSet 方法 (vsbackup.h)

同时提交此集中的所有卷影副本。

语法

HRESULT DoSnapshotSet(
  [out] IVssAsync **ppAsync
);

参数

[out] ppAsync

指向所需 IVssAsync 异步接口的双间接指针。 这用于查询方法执行状态并检索最终错误代码。

返回值

下面是此方法的有效返回代码。 这些错误代码可以从此方法返回,也可以从 ppAsync 参数中返回的 IVssAsync 接口上的 QueryStatus 方法返回。

含义
S_OK
已成功返回指向 IVssAsync 接口实例的指针。 有关 pHrResult 参数返回的有效值,请参阅 IVssAsync::QueryStatus
E_ACCESSDENIED
调用方没有足够的备份权限或不是管理员。
E_INVALIDARG
ppAsync 不指向有效的指针;即,它是 NULL
E_OUTOFMEMORY
调用方内存不足或其他系统资源。
VSS_E_BAD_STATE
在调用 DoSnapshotSet 之前,尚未初始化备份组件对象,或者尚未对给定卷影复制上下文进行先决条件调用。
VSS_E_INSUFFICIENT_STORAGE
系统或提供程序的存储空间不足。 如果可能,请删除任何旧或不必要的永久性卷影副本,然后重试。 此错误代码仅通过 ppAsync 参数中返回的 IVssAsync 接口上的 QueryStatus 方法返回。
VSS_E_FLUSH_WRITES_TIMEOUT
系统无法刷新 I/O 写入。 这可以是暂时性的问题。 建议等待 10 分钟,然后重试,最多三次。
VSS_E_HOLD_WRITES_TIMEOUT
系统无法保存 I/O 写入。 这可以是暂时性的问题。 建议等待 10 分钟,然后重试,最多三次。
VSS_E_NESTED_VOLUME_LIMIT
指定的卷嵌套太深,无法参与 VSS 操作。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 不支持此返回代码。

VSS_E_PROVIDER_VETO
提供程序目前无法执行请求。 这可以是暂时性的问题。 建议等待 10 分钟,然后重试,最多三次。 此错误代码仅通过 ppAsync 参数中返回的 IVssAsync 接口上的 QueryStatus 方法返回。
VSS_E_REBOOT_REQUIRED
提供程序遇到一个错误,要求用户重新启动计算机。

Windows Server 2003 和 Windows XP: 不支持此值。

VSS_E_TRANSACTION_FREEZE_TIMEOUT
系统无法冻结分布式事务处理协调器 (DTC) 或内核事务管理器 (KTM) 。

Windows Server 2003 和 Windows XP: 不支持此值。

VSS_E_TRANSACTION_THAW_TIMEOUT
系统无法解冻分布式事务处理协调器 (DTC) 或内核事务管理器 (KTM) 。

Windows Server 2003 和 Windows XP: 不支持此值。

VSS_E_UNEXPECTED
意外错误。 错误代码记录在错误日志文件中。 有关详细信息,请参阅 VSS 下的事件和错误处理

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 在 Windows Server 2008 R2 和 Windows 7 之前,不支持此值。 改用E_UNEXPECTED。

VSS_E_UNEXPECTED_PROVIDER_ERROR
提供程序返回了意外的错误代码。 这可以是暂时性的问题。 建议等待 10 分钟,然后重试,最多三次。 此错误代码仅通过 ppAsync 参数中返回的 IVssAsync 接口上的 QueryStatus 方法返回。

注解

调用方负责释放 IVssAsync 接口。

无法为嵌套在另一 VHD 中的虚拟硬盘 (VHD) 调用此方法。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 不支持 VHD。

有关如何使用 IVssBackupComponents::D oSnapshotSet 创建标准备份卷影副本的信息,请参阅 预备份任务概述备份的简单卷影副本创建。 有关如何在不同的 VSS 上下文下使用 方法的信息,请参阅 创建卷影副本的实现详细信息

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h)
Library VssApi.lib

另请参阅

IVssAsync

IVssBackupComponents

IVssBackupComponents::AddComponent

IVssBackupComponents::AddToSnapshotSet

IVssBackupComponents::P repareForBackup

IVssBackupComponents::StartSnapshotSet