IOpcRelationshipSelector 接口 (msopc.h)

项目
08/25/2023

表示如何从“关系”部件中选择要引用进行签名的关系。

继承

IOpcRelationshipSelector 接口继承自 IUnknown 接口。 IOpcRelationshipSelector 也有以下类型的成员：

方法

IOpcRelationshipSelector 接口具有这些方法。


IOpcRelationshipSelector：：GetSelectionCriterion 获取用于选择要引用进行签名的关系的字符串。
IOpcRelationshipSelector：：GetSelectorType 获取一个值，该值描述如何选择要引用用于签名的关系。

注解

若要创建 IOpcRelationshipSelector 接口指针，请调用 IOpcRelationshipSelectorSet：：Create 方法。

若要访问 IOpcRelationshipSelector，请调用 IOpcRelationshipSelectorEnumerator：：GetCurrent 方法。

使用 IOpcRelationshipSelector 接口方法选择要签名的关系。如果关系的类型或标识符与通过调用 GetSelectionCriterion 方法检索的字符串匹配，则会选择关系。此字符串是关系类型或关系标识符。调用 GetSelectorType 方法以获取 OPC_RELATIONSHIP_SELECTOR 值，以确定字符串是关系类型还是标识符。若要访问这些关系属性，请调用 IOpcRelationship：：GetRelationshipType 和 IOpcRelationship：：GetId 方法。

下表显示了 OPC_RELATIONSHIP_SELECTOR 值如何映射到关系类型和关系标识符属性。

OPC_RELATIONSHIP_SELECTOR 价值	关系属性	说明
OPC_RELATIONSHIP_SELECT_BY_TYPE	关系类型	选择关系类型与 selectionCriterion 字符串匹配的关系。
OPC_RELATIONSHIP_SELECT_BY_ID	关系标识符	选择关系标识符与 selectionCriterion 字符串匹配的关系。

生成签名时，接口提供的关系选择信息将在签名的 XML 标记中序列化 (签名标记) 。在签名标记中，此信息由第 12 节中指定的 RelationshipReference 和 RelationshipGroupReference 元素表示。 ECMA-376 OpenXML 中的数字签名，第 1 版，第 2 部分：开放打包约定 (OPC) 。下表显示了元素如何映射到关系属性和 OPC_RELATIONSHIP_SELECTOR 值。

包签名元素	关系属性	OPC_RELATIONSHIP_SELECTOR 价值
RelationshipGroupReference	关系类型	OPC_RELATIONSHIP_SELECT_BY_TYPE
RelationshipReference	关系标识符	OPC_RELATIONSHIP_SELECT_BY_ID

线程安全性

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

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

要求

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