Interfaccia IOpcRelationshipSelector (msopc.h)

Articolo
03/05/2024

Rappresenta come selezionare, da una parte Relazioni, le relazioni a cui fare riferimento per la firma.

Ereditarietà

L'interfaccia IOpcRelationshipSelector eredita dall'interfaccia IUnknown . IOpcRelationshipSelector include anche questi tipi di membri:

Metodi

L'interfaccia IOpcRelationshipSelector include questi metodi.


IOpcRelationshipSelector::GetSelectionCriterion Ottiene una stringa usata per selezionare le relazioni a cui fare riferimento per la firma.
IOpcRelationshipSelector::GetSelectorType Ottiene un valore che descrive la modalità di selezione delle relazioni a cui fare riferimento per la firma.

Commenti

Per creare un puntatore dell'interfaccia IOpcRelationshipSelector, chiamare il metodo IOpcRelationshipSelectorSet::Create.

Per accedere a un metodo IOpcRelationshipSelector, chiamare il metodo IOpcRelationshipSelectorEnumerator::GetCurrent.

Usare i metodi di interfaccia IOpcRelationshipSelector per selezionare le relazioni per la firma. Una relazione viene selezionata se il tipo o l'identificatore corrisponde alla stringa recuperata chiamando il metodo GetSelectionCriterion . Questa stringa è un tipo di relazione o un identificatore di relazione. Chiamare il metodo GetSelectorType per ottenere un valore OPC_RELATIONSHIP_SELECTOR per determinare se la stringa è un tipo di relazione o un identificatore. Per accedere a queste proprietà di relazione, chiamare i metodi IOpcRelationship::GetRelationshipType e IOpcRelationship::GetId.

Nella tabella seguente viene illustrato come OPC_RELATIONSHIP_SELECTOR i valori vengono mappati alle proprietà del tipo di relazione e dell'identificatore di relazione.

OPC_RELATIONSHIP_SELECTOR Valore	Relationship, proprietà	Descrizione
OPC_RELATIONSHIP_SELECT_BY_TYPE	Tipo di relazione	Seleziona le relazioni con un tipo di relazione corrispondente alla stringa selectionCriterion .
OPC_RELATIONSHIP_SELECT_BY_ID	Identificatore di relazione	Seleziona le relazioni con un identificatore di relazione che corrisponde alla stringa selectionCriterion .

Quando viene generata una firma, le informazioni di selezione delle relazioni fornite dall'interfaccia vengono serializzate nel markup XML della firma (markup della firma). Nel markup della firma, queste informazioni sono rappresentate dagli elementi RelationshipReference e RelationshipGroupReference , specificati nella sezione 12. Firme digitali in ECMA-376 OpenXML, 1st Edition, Parte 2: Open Packaging Conventions (OPC).Digital Signatures in the ECMA-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC). Nella tabella seguente viene illustrato come gli elementi vengono mappati alle proprietà della relazione e ai valori OPC_RELATIONSHIP_SELECTOR .

Elemento firma pacchetto	Relationship, proprietà	OPC_RELATIONSHIP_SELECTOR Valore
RelationshipGroupReference	Tipo di relazione	OPC_RELATIONSHIP_SELECT_BY_TYPE
RelationshipReference	Identificatore di relazione	OPC_RELATIONSHIP_SELECT_BY_ID

Thread safety

Gli oggetti di creazione dei pacchetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API Creazione pacchetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	msopc.h