SetBackupSucceeded 方法指示特定编写器的指定组件的备份是否成功。
语法
HRESULT SetBackupSucceeded(
[in] VSS_ID instanceId,
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] bool bSucceded
);
参数
[in] instanceId
编写器实例的全局唯一标识符 (GUID) 。
[in] writerId
编写器类的 GUID) (全局唯一标识符。
[in] ct
组件的类型。 有关可能的值，请参阅 VSS_COMPONENT_TYPE 。
[in] wszLogicalPath
包含组件的逻辑路径的以 Null 结尾的宽字符串。
有关详细信息，请参阅 组件的逻辑路径。
包含此处使用的逻辑路径的字符串的值应与使用 IVssBackupComponents：：AddComponent 将组件添加到备份集时使用的相同。
逻辑路径可以为 NULL。
对于可以出现在非 NULL 逻辑路径中的字符没有限制。
[in] wszComponentName
包含组件名称的以 Null 结尾的宽字符串。
字符串不能为 NULL ，并且应包含与使用 IVssBackupComponents：：AddComponent 将组件添加到备份集时使用的组件名称相同。
[in] bSucceded
如果已成功备份组件，请将此参数设置为 true ，否则将 设置为 false 。
返回值
下面是此方法的有效返回代码。
| 值 | 含义 |
|---|---|
|
已成功设置备份成功状态。 |
|
其中一个参数值无效。 |
|
调用方内存或其他系统资源不足。 |
|
备份组件对象未初始化，在还原操作期间调用了此方法，或者未按正确的顺序调用此方法。 |
|
备份组件不存在。 |
|
XML 文档无效。 有关详细信息，请查看事件日志。 有关详细信息，请参阅 VSS 下的事件和错误处理。 |
|
意外错误。 错误代码记录在错误日志文件中。 有关详细信息，请参阅 VSS 下的事件和错误处理。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 在 Windows Server 2008 R2 和 Windows 7 之前不支持此值。 改用E_UNEXPECTED。 |
备注
在组件模式下工作时 (当调用 IVssBackupComponents：：SetBackupState 并将其 select components 参数设置为 true) 时，编写器使用 IVssComponent：：GetBackupSucceeded 检查每个组件备份的状态。 因此，行为良好的备份应用程序 (请求者) 必须在处理每个组件后调用 SetBackupSucceededed ，然后再调用 IVssBackupComponents：：BackupComplete。
如果对 IVssBackupComponents：:D oSnapshotSet 的调用失败，请不要调用此方法。 有关请求者如何在备份操作中使用 DoSnapshotSet、 SetBackupSucceeded 和 BackupComplete 的详细信息，请参阅 预备份任务概述 和 文件的实际备份概述。
要求
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h) |
| Library | VssApi.lib |
另请参阅
IVssBackupComponents：：BackupComplete