IVssBackupComponents：：AddRestoreSubcomponent 方法 (vsbackup.h)

  • 项目

AddRestoreSubcomponent 方法指示，无论组件集的任何其他成员是否会还原，组件集的子组件成员（已标记为不可选择进行备份，但标记为可还原）。

语法

HRESULT AddRestoreSubcomponent(
  [in] VSS_ID             writerId,
  [in] VSS_COMPONENT_TYPE componentType,
  [in] LPCWSTR            wszLogicalPath,
  [in] LPCWSTR            wszComponentName,
  [in] LPCWSTR            wszSubComponentLogicalPath,
  [in] LPCWSTR            wszSubComponentName,
  [in] bool               bRepair
);

参数

[in] writerId

编写器类标识符。

[in] componentType

标识组件的类型。 有关可能的返回值，请参阅 VSS_COMPONENT_TYPE 文档。

[in] wszLogicalPath

以 Null 结尾的宽字符串，其中包含备份文档中组件的逻辑路径，该组件定义备份组件集，其中包含要添加用于还原的子组件。

此参数的值可以为 NULL。

对于可以出现在非 NULL 逻辑路径中的字符没有限制。

[in] wszComponentName

以 Null 结尾的宽字符串，其中包含备份文档中组件的逻辑路径，该组件定义备份组件集，其中包含要添加用于还原的子组件。

此参数的值不能为 NULL。

对于可以出现在非 NULL 组件名称中的字符没有限制。

[in] wszSubComponentLogicalPath

以 Null 结尾的宽字符串，其中包含要添加用于还原的子组件逻辑路径。

添加子组件时需要逻辑路径。 因此，此参数的值不能为 NULL。

对于可以出现在非 NULL 逻辑路径中的字符没有限制。

[in] wszSubComponentName

以 Null 结尾的宽字符串，其中包含要添加用于还原的子组件逻辑名称。

此参数的值不能为 NULL。

对于可以出现在非 NULL 组件名称中的字符没有限制。

[in] bRepair

此参数留待将来使用。 此参数应始终设置为 false

返回值

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

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

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

注解

在调用 AddRestoreSubcomponent 之前，必须先选择 wszLogicalPath 和 wszComponentName 参数定义的根组件，以便使用 IVssBackupComponents：：SetSelectedForRestore 进行还原。

如果请求者要支持还原子组件，则必须在 IVssBackupComponents：:P reReRestore 之前调用此方法。

AddRestoreSubcomponent 适用于编写器组件集中的所有文件必须作为一个单元进行备份的情况，但希望所选文件 (子组件) 能够单独还原。

若要参与此类还原，子组件必须将 VSS_COMPONENTINFO 的 bSelectableForRestore 成员设置为 TRUE。 还必须选择 wszLogicalPath 和 wszComponentName 参数定义的组件，以便使用 IVssBackupComponents：：SetSelectedForRestore 进行还原。

有关详细信息，请参阅 使用 Restore 和 Subcomponents 的可选择性 。

要求

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

另请参阅

IVssBackupComponents

IVssBackupComponents：:P reRestore

VSS_COMPONENT_TYPE