IVssBackupComponents：：SetRangesFilePath 方法 (vsbackup.h)
当部分文件操作需要范围文件，并且该文件已还原到其原始文件以外的其他位置时，将使用 SetRangesFilePath 方法。
语法
HRESULT SetRangesFilePath(
[in] VSS_ID writerId,
[in] VSS_COMPONENT_TYPE ct,
[in] LPCWSTR wszLogicalPath,
[in] LPCWSTR wszComponentName,
[in] UINT iPartialFile,
[in] LPCWSTR wszRangesFile
);
参数
[in] writerId
包含部分文件操作中涉及的文件的编写器类的全局唯一标识符 (GUID) 。
[in] ct
标识组件的类型。 有关可能的返回值 ，请参阅VSS_COMPONENT_TYPE 。
[in] wszLogicalPath
以 Null 结尾的宽字符串，包含组件（包含参与部分文件操作的文件）的逻辑路径。
有关详细信息，请参阅组件的逻辑路径。
包含此处使用的逻辑路径的字符串的值应与使用 IVssBackupComponents：：AddComponent 将组件添加到备份集时使用的值相同。
逻辑路径可以为 NULL。
对可以出现在非 NULL 逻辑路径中的字符没有限制。
[in] wszComponentName
以 Null 结尾的宽字符串，包含包含参与部分文件操作的文件的组件的名称。
字符串不能为 NULL ，应包含与使用 IVssBackupComponents：：AddComponent 将组件添加到备份集时使用的组件名称相同。
[in] iPartialFile
部分文件的索引号。 此参数的值是一个介于 0 到 n–1（含）的整数，其中 n 是与给定组件关联的部分文件总数。 n 的值由 IVssComponent：：GetPartialFileCount 返回。
[in] wszRangesFile
以 Null 结尾的宽字符串，包含范围文件的完全限定路径。
返回值
下面是此方法的有效返回代码。
| 值 | 含义 |
|---|---|
|
已成功添加新的还原目标。 |
|
其中一个参数值无效。 |
|
调用方内存不足或其他系统资源。 |
|
备份组件对象未初始化，或者已在还原操作期间调用此方法。 |
|
组件不存在，或者路径和文件规范与组件中的组件和文件规范不匹配。 |
|
XML 文档无效。 有关详细信息，请查看事件日志。 有关详细信息，请参阅 VSS 下的事件和错误处理。 |
|
意外错误。 错误代码记录在错误日志文件中。 有关详细信息，请参阅 VSS 下的事件和错误处理。
Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 在 Windows Server 2008 R2 和 Windows 7 之前，不支持此值。 改用E_UNEXPECTED。 |
注解
如果已就地还原范围文件，则不需要调用 SetRangesFilePath 。
要求
| 最低受支持的客户端 | Windows Vista [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h) |
| Library | VssApi.lib |