Интерфейс IOpcRelationshipSelector (msopc.h)

Статья
08/25/2023

Представляет способ выбора в части "Связи" связей, на которые необходимо ссылаться для подписывания.

Наследование

Интерфейс IOpcRelationshipSelector наследуется от интерфейса IUnknown . IOpcRelationshipSelector также имеет следующие типы элементов:

Методы

Интерфейс IOpcRelationshipSelector содержит следующие методы.


IOpcRelationshipSelector::GetSelectionCriterion Возвращает строку, используемую для выбора связей для подписывания.
IOpcRelationshipSelector::GetSelectorType Возвращает значение, описывающее, как выбираются связи, на которые необходимо ссылаться для подписывания.

Используйте методы интерфейса IOpcRelationshipSelector для выбора связей для подписывания. Связь выбирается, если ее тип или идентификатор соответствует строке, полученной путем вызова метода GetSelectionCriterion . Эта строка является типом связи или идентификатором связи. Вызовите метод GetSelectorType , чтобы получить OPC_RELATIONSHIP_SELECTOR значение, чтобы определить, является ли строка типом связи или идентификатором. Чтобы получить доступ к этим свойствам связи, вызовите методы IOpcRelationship::GetRelationshipType и IOpcRelationship::GetId .

В следующей таблице показано, как OPC_RELATIONSHIP_SELECTOR значения сопоставляют со свойствами типа связи и идентификатора связи.

OPC_RELATIONSHIP_SELECTOR Значение	Свойство Relationship	Описание
OPC_RELATIONSHIP_SELECT_BY_TYPE	Тип отношений	Выбирает связи, имеющие тип связи, соответствующий строке selectionCriterion .
OPC_RELATIONSHIP_SELECT_BY_ID	Идентификатор связи	Выбирает связи, имеющие идентификатор связи, соответствующий строке selectionCriterion .

При создании сигнатуры сведения о выборе связей, предоставляемые интерфейсом, сериализуются в XML-разметке подписи (разметке подписи). В разметке сигнатуры эти сведения представлены элементами RelationshipReference и RelationshipGroupReference , которые указаны в разделе 12. Цифровые подписи в ECMA-376 OpenXML, 1-е издание, часть 2. Открытые соглашения об упаковке (OPC). В следующей таблице показано, как элементы сопоставляют со свойствами связи и OPC_RELATIONSHIP_SELECTOR значениями.

Элемент подписи пакета	Свойство Relationship	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
Header	msopc.h