iOpcRelationship::GetId 方法 (msopc.h)
获取关系的唯一标识符。
语法
HRESULT GetId(
[out, retval] LPWSTR *relationshipIdentifier
);
参数
[out, retval] relationshipIdentifier
该关系的标识符。
关系的标识符是任意的,并且是包的本地标识符,因此为 。
有效的标识符符合 xsd:ID 的限制,这些限制记录在 W3C 建议的第 3.3.8 部分 ID,XML 架构第 2 部分:数据类型第二版 (http://www.w3.org/TR/xmlschema-2/#ID) 。
返回值
该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
relationshipIdentifier 参数为 NULL。 |
注解
关系的标识符对于查找关系没有用,因为它是任意的,并且是包的本地标识符。
查找感兴趣的部分的最终方法是使用关系类型。
查找部件需要几个步骤。 有关查找部件的详细信息,请参阅 查找核心属性部件。
此方法分配 relationshipIdentifier 中返回的字符串使用的内存。 如果方法成功,请调用 CoTaskMemFree 函数以释放内存。
有关关系的详细信息,请参阅 开放打包约定基础知识 和 ECMA-376 OpenXML,第 1 版,第 2 部分:开放打包约定 (OPC) 。
线程安全性
打包对象不是线程安全的。
有关详细信息,请参阅打包 API 的入门。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 7 [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
目标平台 | Windows |
标头 | msopc.h |
另请参阅
外部资源
概述
引用