IVssBackupComponents::D oSnapshotSet 方法 (vsbackup.h)
同时提交此集中的所有卷影副本。
语法
HRESULT DoSnapshotSet(
[out] IVssAsync **ppAsync
);
参数
[out] ppAsync
指向所需 IVssAsync 异步接口的双间接指针。 这用于查询方法执行状态并检索最终错误代码。
返回值
下面是此方法的有效返回代码。 这些错误代码可以从此方法返回,也可以从 ppAsync 参数中返回的 IVssAsync 接口上的 QueryStatus 方法返回。
值 | 含义 |
---|---|
|
已成功返回指向 IVssAsync 接口实例的指针。 有关 pHrResult 参数返回的有效值,请参阅 IVssAsync::QueryStatus。 |
|
调用方没有足够的备份权限或不是管理员。 |
|
ppAsync 不指向有效的指针;即,它是 NULL。 |
|
调用方内存不足或其他系统资源。 |
|
在调用 DoSnapshotSet 之前,尚未初始化备份组件对象,或者尚未对给定卷影复制上下文进行先决条件调用。 |
|
系统或提供程序的存储空间不足。 如果可能,请删除任何旧或不必要的永久性卷影副本,然后重试。 此错误代码仅通过 ppAsync 参数中返回的 IVssAsync 接口上的 QueryStatus 方法返回。 |
|
系统无法刷新 I/O 写入。 这可以是暂时性的问题。 建议等待 10 分钟,然后重试,最多三次。 |
|
系统无法保存 I/O 写入。 这可以是暂时性的问题。 建议等待 10 分钟,然后重试,最多三次。 |
|
指定的卷嵌套太深,无法参与 VSS 操作。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 不支持此返回代码。 |
|
提供程序目前无法执行请求。 这可以是暂时性的问题。 建议等待 10 分钟,然后重试,最多三次。 此错误代码仅通过 ppAsync 参数中返回的 IVssAsync 接口上的 QueryStatus 方法返回。 |
|
提供程序遇到一个错误,要求用户重新启动计算机。
Windows Server 2003 和 Windows XP: 不支持此值。 |
|
系统无法冻结分布式事务处理协调器 (DTC) 或内核事务管理器 (KTM) 。
Windows Server 2003 和 Windows XP: 不支持此值。 |
|
系统无法解冻分布式事务处理协调器 (DTC) 或内核事务管理器 (KTM) 。
Windows Server 2003 和 Windows XP: 不支持此值。 |
|
意外错误。 错误代码记录在错误日志文件中。 有关详细信息,请参阅 VSS 下的事件和错误处理。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 在 Windows Server 2008 R2 和 Windows 7 之前,不支持此值。 改用E_UNEXPECTED。 |
|
提供程序返回了意外的错误代码。 这可以是暂时性的问题。 建议等待 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 |
另请参阅
IVssBackupComponents::AddComponent
IVssBackupComponents::AddToSnapshotSet