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 结尾的宽字符串，包含范围文件的完全限定路径。

返回值

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

值 含义
S_OK
 已成功添加新的还原目标。
E_INVALIDARG
 其中一个参数值无效。
E_OUTOFMEMORY
 调用方内存不足或其他系统资源。
VSS_E_BAD_STATE
 备份组件对象未初始化，或者已在还原操作期间调用此方法。
VSS_E_OBJECT_NOT_FOUND
 组件不存在，或者路径和文件规范与组件中的组件和文件规范不匹配。
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。

注解

如果已就地还原范围文件，则不需要调用 SetRangesFilePath 。

要求

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

另请参阅

IVssBackupComponents

IVssComponent：：AddPartialFile

IVssComponent：：GetPartialFile

IVssComponent：：GetPartialFileCount