IVssComponent：：GetNewTarget 方法 (vswriter.h)

GetNewTarget 方法返回所选组件或组件集的新文件还原位置。 (有关选择组件的信息，请参阅使用可选择性和逻辑路径。)

编写器或请求者都可以调用此方法。

语法

HRESULT GetNewTarget(
  [in]  UINT           iNewTarget,
  [out] IVssWMFiledesc **ppFiledesc
);

[in] iNewTarget

新目标的索引号。此参数的值是介于 0 到 n–1（含）的整数之间，其中 n 是与给定组件关联的新目标的总数。 n 的值由 IVssComponent：：GetNewTargetCount 返回。

[out] ppFiledesc

指向包含新目标还原位置信息的 IVssWMFiledesc 对象的双间接指针。

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

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

GetNewTarget 返回的新目标不仅可以是当前组件中的文件，也可能是其任何不可选择的子组件中的文件。