IOpcRelationship::GetTargetUri 方法(msopc.h)

获取关系目标的 URI。

Syntax

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

参数

[out, retval] targetUri

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

如果关系目标是内部的,则目标是一部分,而目标的 URI 与源部件的 URI 相对。

返回值

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

返回代码 Description
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 入门

要求

Requirement 价值
最低支持的客户端 Windows 7 [仅限桌面应用]
支持的最低服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows操作系统
Header msopc.h

另请参阅

ECMA-376 OpenXML

外部资源

打包 API 入门

IOpcRelationship

OPC_URI_TARGET_MODE

开放打包约定基础知识

概述

打包 API 参考

打包 API 示例

引用

关系概述

从目标 URI 解析部件名称