IVssBackupComponents：：SetBackupState 方法 (vsbackup.h)

  • 项目

SetBackupState 方法定义备份操作的总体配置。

语法

HRESULT SetBackupState(
  [in] bool            bSelectComponents,
  [in] bool            bBackupBootableSystemState,
  [in] VSS_BACKUP_TYPE backupType,
  [in] bool            bPartialFileSupport
);

参数

[in] bSelectComponents

指示备份或还原操作是否将处于组件模式。

组件模式下的操作支持有选择地备份指定的单个组件 (这可以允许其排除) ，或仅支持备份卷上的所有文件和组件。

如果操作将在组件模式下执行，则布尔值为 true ;否则为 false 。

[in] bBackupBootableSystemState

指示是否正在执行可启动的系统状态备份。

[in] backupType

指示要执行的备份类型的 VSS_BACKUP_TYPE 枚举值。

[in] bPartialFileSupport

可选。 如果此参数的值为 true，则启用部分文件支持。 此参数的默认值为 false。

返回值

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

值 含义
S_OK
 已成功设置备份状态。
E_INVALIDARG
 其中一个参数值无效。
E_OUTOFMEMORY
 调用方内存不足或其他系统资源。
VSS_E_BAD_STATE
 备份组件对象未初始化，在还原操作期间调用了此方法，或者尚未在正确的顺序中调用此方法。
VSS_E_INVALID_XML_DOCUMENT
 XML 文档无效。 有关详细信息，请查看事件日志。 有关详细信息，请参阅 VSS 下的事件和错误处理。
VSS_E_UNEXPECTED
 意外错误。 错误代码记录在错误日志文件中。 有关详细信息，请参阅 VSS 下的事件和错误处理。

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

注解

在调用 IVssBackupComponents：:P repareForBackup 之前，应用程序必须调用 SetBackupState。

要求

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

另请参阅

IVssBackupComponents

VSS_BACKUP_TYPE