IVssBackupComponents：：SetSelectedForRestore 方法 (vsbackup.h)
SetSelectedForRestore 方法指示是否选择指定的可选组件进行还原。
语法
HRESULT SetSelectedForRestore(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] bool bSelectedForRestore
);
参数
[in] writerId
编写器标识符。
[in] ct
组件的类型。 有关可能的值 ，请参阅VSS_COMPONENT_TYPE 。
[in] wszLogicalPath
以 Null 结尾的宽字符串，包含组件的逻辑路径。 有关详细信息，请参阅组件的逻辑路径。
包含此处使用的逻辑路径的字符串的值应与添加组件时使用的相同。
逻辑路径可以为 NULL。
对可以出现在非 NULL 逻辑路径中的字符没有限制。
[in] wszComponentName
包含组件名称的以 Null 结尾的宽字符串。
字符串不能为 NULL ，应包含与使用 IVssBackupComponents：：AddComponent 将组件添加到备份集时使用的组件名称相同。
[in] bSelectedForRestore
如果此参数的值为 true，则表示已选择所选组件进行还原。 如果值为 false，则表示尚未选择所选组件进行还原。
返回值
下面是此方法的有效返回代码。
| 值 | 含义 |
|---|---|
|
已成功指示已选择要还原的指定组件。 |
|
其中一个参数值无效。 |
|
调用方内存不足或其他系统资源。 |
|
备份组件对象未初始化，在还原操作期间调用了此方法，或者尚未在正确的顺序中调用此方法。 |
|
正在选择的组件不存在于备份组件文档中，或者与该组件对应的编写器实时实例未在系统上运行。 |
|
XML 文档无效。 有关详细信息，请查看事件日志。 有关详细信息，请参阅 VSS 下的事件和错误处理。 |
|
意外错误。 错误代码记录在错误日志文件中。 有关详细信息，请参阅 VSS 下的事件和错误处理。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 在 Windows Server 2008 R2 和 Windows 7 之前，不支持此值。 改用E_UNEXPECTED。 |
注解
SetSelectedForRestore 仅适用于在组件模式下进行的还原。
只能为使用 IVssBackupComponents：：AddComponent 在备份时显式添加到备份文档的组件调用 SetSelectedForRestore。 必须通过在添加到文档的最接近的上级组件上调用 SetSelectedForRestore 来还原已隐式选择作为组件集一部分进行备份的组件。 如果仅要还原此组件的数据，则应通过 IVssBackupComponents：：AddRestoreSubcomponent 完成此操作;仅当组件可以选择用于还原时，才能执行此操作 (请参阅 使用选择性和逻辑路径) 。
必须在 IVssBackupComponents：:P reRestore 之前调用此方法。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows XP [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h) |
| Library | VssApi.lib |
另请参阅
IVssBackupComponents：:P reRestore