Share via

IVssComponent：：GetRestoreSubcomponent 方法 (vswriter.h)

  • 项目

GetRestoreSubcomponent 方法返回与给定组件关联的指定子组件。

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

语法

HRESULT GetRestoreSubcomponent(
  [in]  UINT iComponent,
  [out] BSTR *pbstrLogicalPath,
  [out] BSTR *pbstrComponentName,
  [out] bool *pbRepair
);

参数

[in] iComponent

子组件索引。 此参数的值是一个介于 0 到 n–1（含 0 到 n–1）的整数，其中 n 是与给定组件关联的子组件总数。 n 的值由 IVssComponent：：GetRestoreSubcomponentCount 返回。

[out] pbstrLogicalPath

指向包含子组件逻辑路径的字符串的指针。 使用子组件时，逻辑路径不能为空。

[out] pbstrComponentName

指向包含子组件名称的字符串的指针。 该字符串不能为空。

[out] pbRepair

保留供将来使用。

返回值

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

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

注解

调用方应通过调用 SysFreeString 释放 pbstrLogicalPath 和 pbstrComponentName 参数保留的内存。

要求

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

另请参阅

IVssComponent