IOpcRelationshipSelector-Schnittstelle (msopc.h)

Artikel
08/25/2023

Stellt dar, wie aus einem Beziehungsteil die Beziehungen ausgewählt werden, auf die beim Signieren verwiesen werden soll.

Vererbung

Die IOpcRelationshipSelector-Schnittstelle erbt von der IUnknown-Schnittstelle . IOpcRelationshipSelector verfügt auch über folgende Membertypen:

Methoden

Die IOpcRelationshipSelector-Schnittstelle verfügt über diese Methoden.


IOpcRelationshipSelector::GetSelectionCriterion Ruft eine Zeichenfolge ab, die zum Auswählen von Beziehungen verwendet wird, auf die beim Signieren verwiesen werden soll.
IOpcRelationshipSelector::GetSelectorType Ruft einen Wert ab, der beschreibt, wie Beziehungen ausgewählt werden, auf die beim Signieren verwiesen werden soll.

Hinweise

Um einen IOpcRelationshipSelector-Schnittstellenzeiger zu erstellen, rufen Sie die IOpcRelationshipSelectorSet::Create-Methode auf.

Rufen Sie die IOpcRelationshipSelector-Methode auf, um auf eine IOpcRelationshipSelectorEnumerator::GetCurrent-Methode zuzugreifen.

Verwenden Sie die IOpcRelationshipSelector-Schnittstellenmethoden , um Beziehungen zum Signieren auszuwählen. Eine Beziehung wird ausgewählt, wenn ihr Typ oder Bezeichner mit der Zeichenfolge übereinstimmt, die durch Aufrufen der GetSelectionCriterion-Methode abgerufen wird. Diese Zeichenfolge ist entweder ein Beziehungstyp oder ein Beziehungsbezeichner. Rufen Sie die GetSelectorType-Methode auf, um einen OPC_RELATIONSHIP_SELECTOR Wert abzurufen, um zu bestimmen, ob die Zeichenfolge ein Beziehungstyp oder ein Bezeichner ist. Um auf diese Beziehungseigenschaften zuzugreifen, rufen Sie die Methoden IOpcRelationship::GetRelationshipType und IOpcRelationship::GetId auf .

Die folgende Tabelle zeigt, wie OPC_RELATIONSHIP_SELECTOR Werte den Eigenschaften beziehungstyp und Beziehungsbezeichner zugeordnet werden.

OPC_RELATIONSHIP_SELECTOR Wert	Relationship-Eigenschaft	BESCHREIBUNG
OPC_RELATIONSHIP_SELECT_BY_TYPE	Beziehungstyp	Wählt Beziehungen aus, die über einen Beziehungstyp verfügen, der mit selectionCriterion string übereinstimmt.
OPC_RELATIONSHIP_SELECT_BY_ID	Beziehungsbezeichner	Wählt Beziehungen aus, die über einen Beziehungsbezeichner verfügen, der mit selectionCriterion string übereinstimmt.

Wenn eine Signatur generiert wird, werden die von der Schnittstelle bereitgestellten Informationen zur Beziehungsauswahl im XML-Markup der Signatur (Signaturmarkup) serialisiert. Im Signaturmarkup werden diese Informationen durch die Elemente RelationshipReference und RelationshipGroupReference dargestellt, die in Abschnitt 12 angegeben sind. Digitale Signaturen im ECMA-376 OpenXML, 1. Edition, Teil 2: Open Packaging Conventions (OPC). Die folgende Tabelle zeigt, wie die Elemente Beziehungseigenschaften und OPC_RELATIONSHIP_SELECTOR Werten zugeordnet werden.

Paketsignaturelement	Relationship-Eigenschaft	OPC_RELATIONSHIP_SELECTOR Wert
RelationshipGroupReference	Beziehungstyp	OPC_RELATIONSHIP_SELECT_BY_TYPE
RelationshipReference	Beziehungsbezeichner	OPC_RELATIONSHIP_SELECT_BY_ID

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie in der Erste Schritte mit der Paketerstellungs-API.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h