IOpcRelationship::GetTargetUri 方法 (msopc.h)

获取关系目标的 URI。

语法

HRESULT GetTargetUri(
  [out, retval] IUri **targetUri
);

参数

[out, retval] targetUri

指向 URI 的 IUri 接口的指针,该 URI 表示关系目标 URI。

如果关系目标是内部的,则目标是一个部分,并且目标的 URI 相对于源部件的 URI。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。
E_POINTER
targetUri 参数为 NULL

注解

查找感兴趣的部分的最终方法是使用关系类型。

查找感兴趣的部分需要几个步骤。 有关查找部件的详细信息,请参阅 部件概述查找核心属性部件

若要确定关系的目标是内部还是外部,请调用 GetTargetUri 方法。

如果关系目标是内部的,则目标是一个部分。

如果关系目标是一部分,则 targetUri 中的 URI 相对于关系源的 URI。

如果关系目标是一个部件,则通过从 GetSourceUri 方法的 sourceUri 参数中收到的 IOpcUri 接口指针调用 IOpcUri::CombinePartUri 方法来形成部件名称。 使用 targetUri 中收到的相对 URI 作为 IOpcUri::CombinePartUri 调用的输入参数。 有关示例,请参阅 从目标 URI 解析部件名称

有关关系的详细信息,请参阅 开放打包约定基础知识ECMA-376 OpenXML,第 1 版第 2 部分:开放打包约定 (OPC)

线程安全性

打包对象不是线程安全的。

有关详细信息,请参阅打包 API 的入门

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 msopc.h

另请参阅

ECMA-376 OpenXML

外部资源

使用打包 API 入门

IOpcRelationship

OPC_URI_TARGET_MODE

开放打包约定基础知识

概述

打包 API 参考

打包 API 示例

引用

关系概述

从目标 URI 解析部件名称