Interface IOpcRelationshipSelector (msopc.h)

Artigo
02/29/2024

Representa como selecionar, em uma parte Relações, as relações a serem referenciadas para assinatura.

Herança

A interface IOpcRelationshipSelector herda da interface IUnknown . IOpcRelationshipSelector também tem esses tipos de membros:

Métodos

A interface IOpcRelationshipSelector tem esses métodos.


IOpcRelationshipSelector::GetSelectionCriterion Obtém uma cadeia de caracteres usada para selecionar relações a serem referenciadas para assinatura.
IOpcRelationshipSelector::GetSelectorType Obtém um valor que descreve como as relações são selecionadas para serem referenciadas para assinatura.

Comentários

Para criar um ponteiro de interface IOpcRelationshipSelector , chame o método IOpcRelationshipSelectorSet::Create .

Para acessar um IOpcRelationshipSelector, chame o método IOpcRelationshipSelectorEnumerator::GetCurrent .

Use os métodos de interface IOpcRelationshipSelector para selecionar relações para assinatura. Uma relação será selecionada se seu tipo ou identificador corresponder à cadeia de caracteres recuperada chamando o método GetSelectionCriterion . Essa cadeia de caracteres é um tipo de relação ou um identificador de relação. Chame o método GetSelectorType para obter um valor OPC_RELATIONSHIP_SELECTOR para determinar se a cadeia de caracteres é um tipo de relação ou um identificador. Para acessar essas propriedades de relação, chame os métodos IOpcRelationship::GetRelationshipType e IOpcRelationship::GetId .

A tabela a seguir mostra como os valores de OPC_RELATIONSHIP_SELECTOR são mapeados para o tipo de relação e as propriedades do identificador de relação.

OPC_RELATIONSHIP_SELECTOR Valor	Propriedade Relationship	Descrição
OPC_RELATIONSHIP_SELECT_BY_TYPE	Tipo de relação	Seleciona relações que têm um tipo de relação que corresponde à cadeia de caracteres selectionCriterion .
OPC_RELATIONSHIP_SELECT_BY_ID	Identificador de relação	Seleciona relações que têm um identificador de relação que corresponde à cadeia de caracteres selectionCriterion .

Quando uma assinatura é gerada, as informações de seleção de relação fornecidas pela interface são serializadas na marcação XML da assinatura (marcação de assinatura). Na marcação de assinatura, essas informações são representadas pelos elementos RelationshipReference e RelationshipGroupReference , que são especificados na seção 12. Assinaturas digitais no ECMA-376 OpenXML, 1ª Edição, Parte 2: Open Packaging Conventions (OPC). A tabela a seguir mostra como os elementos são mapeados para propriedades de relação e para OPC_RELATIONSHIP_SELECTOR valores.

Elemento package signature	Propriedade Relationship	OPC_RELATIONSHIP_SELECTOR Valor
RelationshipGroupReference	Tipo de relação	OPC_RELATIONSHIP_SELECT_BY_TYPE
RelationshipReference	Identificador de relação	OPC_RELATIONSHIP_SELECT_BY_ID

Acesso thread-safe

Os objetos de empacotamento não são thread-safe.

Para obter mais informações, consulte o Introdução com a API de Empacotamento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	msopc.h