IVssComponent：：GetAlternateLocationMapping 方法 (vswriter.h)

GetAlternateLocationMapping 用于返回文件集的文件还原备用位置。此方法可由编写器或请求者调用。

语法

HRESULT GetAlternateLocationMapping(
  [in]  UINT           iMapping,
  [out] IVssWMFiledesc **ppFiledesc
);

[in] iMapping

特定映射的索引。此参数的值是一个介于 0 到 n–1（含 0 到 n–1）的整数，其中 n 是与当前组件关联的备用位置映射的总数。 n 的值由 IVssComponent：：GetAlternateLocationMappingCount 返回。

[out] ppFiledesc

指向包含映射信息的 IVssWMFiledesc 对象的双重间接指针。

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

值	含义
S_OK	已成功返回属性值。
E_INVALIDARG	其中一个参数值无效。
E_OUTOFMEMORY	调用方内存或其他系统资源不足。
VSS_E_INVALID_XML_DOCUMENT	XML 文档无效。有关详细信息，请查看事件日志。有关详细信息，请参阅 VSS 下的事件和错误处理。
VSS_E_OBJECT_NOT_FOUND	找不到指定的项。

GetAlternateLocationMapping 返回的备用位置映射不仅可以来自当前组件中的文件，还可以来自其任何不可选择的子组件中的文件。

IVssComponent：：GetAlternateLocationMapping 返回的值也不应与 IVssExamineWriterMetadata：：GetAlternateLocationMapping 返回的值混淆：

如果以下任一情况为 true，应始终将文件还原到其备用位置映射：

在任一情况下，未定义备用位置映射都构成编写器错误。

如果符合以下任一条件，则可以将文件还原到备用位置映射：

备用位置映射仅在还原操作期间使用，不应与仅在备份操作期间使用的备用路径混淆。

GetAlternateLocationMapping 返回的映射引用还原文件过程中使用的备用位置映射。

调用方必须使用它指向的 IVssWMFiledesc 对象调用 IUnknown：：Release 来释放 ppMapping 参数持有的系统资源。

有关 VSS 下备份和还原文件位置的详细信息，请参阅非默认备份和还原位置。