Interface IOpcRelationshipSelector (msopc.h)

Article
10/26/2023

Représente comment sélectionner, dans une partie Relations, les relations à référencer pour la signature.

Héritage

L’interface IOpcRelationshipSelector hérite de l’interface IUnknown. IOpcRelationshipSelector a également les types de membres suivants :

Méthodes

L’interface IOpcRelationshipSelector possède ces méthodes.


IOpcRelationshipSelector ::GetSelectionCriterion Obtient une chaîne utilisée pour sélectionner les relations à référencer pour la signature.
IOpcRelationshipSelector ::GetSelectorType Obtient une valeur qui décrit la façon dont les relations sont sélectionnées pour être référencées pour la signature.

Remarques

Pour créer un pointeur d’interface IOpcRelationshipSelector , appelez la méthode IOpcRelationshipSelectorSet ::Create .

Pour accéder à un IOpcRelationshipSelector, appelez la méthode IOpcRelationshipSelectorEnumerator ::GetCurrent .

Utilisez les méthodes d’interface IOpcRelationshipSelector pour sélectionner les relations à signer. Une relation est sélectionnée si son type ou son identificateur correspond à la chaîne récupérée en appelant la méthode GetSelectionCriterion . Cette chaîne est un type de relation ou un identificateur de relation. Appelez la méthode GetSelectorType pour obtenir une valeur OPC_RELATIONSHIP_SELECTOR afin de déterminer si la chaîne est un type de relation ou un identificateur. Pour accéder à ces propriétés de relation, appelez les méthodes IOpcRelationship ::GetRelationshipType et IOpcRelationship ::GetId .

Le tableau suivant montre comment OPC_RELATIONSHIP_SELECTOR valeurs mappées au type de relation et aux propriétés d’identificateur de relation.

OPC_RELATIONSHIP_SELECTOR Valeur	Relation, propriété	Description
OPC_RELATIONSHIP_SELECT_BY_TYPE	Type de relation	Sélectionne les relations qui ont un type de relation qui correspond à selection Stringcriterion .
OPC_RELATIONSHIP_SELECT_BY_ID	Identificateur de relation	Sélectionne les relations qui ont un identificateur de relation qui correspond à selection String decritération .

Lorsqu’une signature est générée, les informations de sélection de relation fournies par l’interface sont sérialisées dans le balisage XML de la signature (balisage de signature). Dans le balisage de signature, ces informations sont représentées par les éléments RelationshipReference et RelationshipGroupReference , qui sont spécifiés dans la section 12. Signatures numériques dans l’ECMA-376 OpenXML, 1ère édition, Partie 2 : Open Packaging Conventions (OPC). Le tableau suivant montre comment les éléments sont mappés aux propriétés de relation et aux valeurs OPC_RELATIONSHIP_SELECTOR .

Élément de signature de package	Relation, propriété	OPC_RELATIONSHIP_SELECTOR Valeur
RelationshipGroupReference	Type de relation	OPC_RELATIONSHIP_SELECT_BY_TYPE
RelationshipReference	Identificateur de relation	OPC_RELATIONSHIP_SELECT_BY_ID

Cohérence de thread

Les objets d’empaquetage ne sont pas thread-safe.

Pour plus d’informations, consultez la Prise en main avec l’API Packaging.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	msopc.h