Interfaz IOpcRelationshipSelector (msopc.h)

Artículo
02/29/2024

Representa cómo seleccionar, en una parte Relaciones, las relaciones a las que se va a hacer referencia para la firma.

Herencia

La interfaz IOpcRelationshipSelector hereda de la interfaz IUnknown . IOpcRelationshipSelector también tiene estos tipos de miembros:

Métodos

La interfaz IOpcRelationshipSelector tiene estos métodos.


IOpcRelationshipSelector::GetSelectionCriterion Obtiene una cadena que se usa para seleccionar las relaciones a las que se va a hacer referencia para la firma.
IOpcRelationshipSelector::GetSelectorType Obtiene un valor que describe cómo se seleccionan las relaciones a las que se hace referencia para la firma.

Comentarios

Para crear un puntero de interfaz IOpcRelationshipSelector , llame al método IOpcRelationshipSelectorSet::Create .

Para acceder a un IOpcRelationshipSelector, llame al método IOpcRelationshipSelectorEnumerator::GetCurrent .

Use los métodos de interfaz IOpcRelationshipSelector para seleccionar las relaciones para firmar. Se selecciona una relación si su tipo o identificador coincide con la cadena recuperada mediante una llamada al método GetSelectionCriterion . Esta cadena es un tipo de relación o un identificador de relación. Llame al método GetSelectorType para obtener un valor de OPC_RELATIONSHIP_SELECTOR para determinar si la cadena es un tipo de relación o un identificador. Para acceder a estas propiedades de relación, llame a los métodos IOpcRelationship::GetRelationshipType e IOpcRelationship::GetId .

En la tabla siguiente se muestra cómo OPC_RELATIONSHIP_SELECTOR valores se asignan al tipo de relación y a las propiedades del identificador de relación.

OPC_RELATIONSHIP_SELECTOR Valor	Relationship (propiedad)	Descripción
OPC_RELATIONSHIP_SELECT_BY_TYPE	Tipo de relación	Selecciona relaciones que tienen un tipo de relación que coincide con la cadena selectionCriterion .
OPC_RELATIONSHIP_SELECT_BY_ID	Identificador de relación	Selecciona las relaciones que tienen un identificador de relación que coincide con la cadena selectionCriterion .

Cuando se genera una firma, la información de selección de relación proporcionada por la interfaz se serializa en el marcado XML de la firma (marcado de firma). En el marcado de firma, esta información se representa mediante los elementos RelationshipReference y RelationshipGroupReference , que se especifican en la sección 12. Firmas digitales en ecma-376 OpenXML, 1ª edición, parte 2: convenciones de empaquetado abierto (OPC). En la tabla siguiente se muestra cómo se asignan los elementos a las propiedades de relación y a OPC_RELATIONSHIP_SELECTOR valores.

Elemento de firma del paquete	Relationship (propiedad)	OPC_RELATIONSHIP_SELECTOR Valor
RelationshipGroupReference	Tipo de relación	OPC_RELATIONSHIP_SELECT_BY_TYPE
RelationshipReference	Identificador de relación	OPC_RELATIONSHIP_SELECT_BY_ID

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para obtener más información, consulte el Introducción con packaging API.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msopc.h