Interface IOpcDigitalSignatureManager (msopc.h)

Artigo
03/08/2023

Fornece acesso às Interfaces de Assinatura Digital de Empacotamento para um pacote representado por objetos da API de Empacotamento. Esses métodos de interface são chamados para gerar uma assinatura ou para acessar e validar assinaturas existentes no pacote.

Herança

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

Métodos

A interface IOpcDigitalSignatureManager tem esses métodos.


IOpcDigitalSignatureManager::CreateSigningOptions Cria um ponteiro de interface IOpcSigningOptions.
IOpcDigitalSignatureManager::GetSignatureEnumerator Obtém um enumerador de ponteiros de interface IOpcDigitalSignature, que representam assinaturas de pacote.
IOpcDigitalSignatureManager::GetSignatureOriginPartName Obtém um ponteiro de interface IOpcPartUri que representa o nome da parte da Origem da Assinatura Digital.
IOpcDigitalSignatureManager::RemoveSignature Remove do pacote uma parte de assinatura especificada que armazena a marcação de assinatura.
IOpcDigitalSignatureManager::ReplaceSignatureXml Substitui a marcação de assinatura existente armazenada em uma parte de assinatura especificada.
IOpcDigitalSignatureManager::SetSignatureOriginPartName Define o nome da parte da Origem da Assinatura Digital como o nome representado por um ponteiro de interface IOpcPartUri especificado.
IOpcDigitalSignatureManager::Sign Assina o pacote gerando uma assinatura usando o certificado especificado e o ponteiro da interface IOpcSigningOptions.
IOpcDigitalSignatureManager::Validate Valida uma assinatura de pacote especificada usando um certificado especificado.

Comentários

Antes que o método Sign seja chamado para gerar uma assinatura, os métodos IOpcSigningOptions::SetDefaultDigestMethod e IOpcSigningOptions::SetSignatureMethod devem ser chamados.

Para criar um ponteiro de interface IOpcDigitalSignatureManager , chame o método IOpcFactory::CreateDigitalSignatureManager .

Importante Se o pacote for modificado enquanto o método Sign estiver sendo executado, o método poderá falhar ou gerar uma assinatura inconsistente. Para evitar a corrupção do pacote, use as APIs para salvar o pacote antes de chamar Sign. Para obter informações sobre como salvar um pacote, consulte Salvando um pacote.

O método Validate verifica se a assinatura especificada (entidades assinadas e a marcação de assinatura) não foi alterada desde que a assinatura foi gerada, mas não valida a identidade do signatário.

Importante O chamador deve validar a identidade do signatário.

Acesso thread-safe

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

IOpcSigningOptions 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