Método IOpcFactory::CreateDigitalSignatureManager (msopc.h)

Artigo
03/05/2024

Cria um objeto gerenciador de assinatura digital para um objeto de pacote.

Sintaxe

HRESULT CreateDigitalSignatureManager(
  [in]          IOpcPackage                 *package,
  [out, retval] IOpcDigitalSignatureManager **signatureManager
);

Parâmetros

[in] package

Um ponteiro para a interface IOpcPackage do objeto de pacote a ser associado ao objeto gerenciador de assinatura digital.

[out, retval] signatureManager

Um ponteiro para a interface IOpcDigitalSignatureManager do objeto gerenciador de assinatura digital criado para uso com o objeto de pacote.

Um objeto gerenciador de assinatura digital fornece acesso aos métodos e interfaces de assinatura digital da API de Empacotamento. Eles podem ser usados para assinar o pacote representado pelo objeto de pacote ou para validar as assinaturas em um pacote que já foi assinado.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor/código retornado	Descrição
S_OK	O método foi bem-sucedido.
E_NOTIMPL	Esse método não é implementado para esta versão do Windows.
OPC_E_DS_DUPLICATE_SIGNATURE_ORIGIN_RELATIONSHIP 0x8051001B	Existe mais de uma relação do tipo de relação de origem da assinatura digital, mas apenas uma dessas relações é permitida. Para obter mais informações sobre esse tipo de relação, consulte o OPC.
OPC_E_DS_INVALID_SIGNATURE_ORIGIN_RELATIONSHIP 0x8051001C	Uma relação de pacote do tipo origem de assinatura digital tem como destino um local externo ao pacote. As partes de Origem da Assinatura Digital devem estar localizadas internamente. Para obter mais informações sobre esse tipo de relação, consulte o OPC.
OPC_E_DS_MISSING_SIGNATURE_ORIGIN_PART 0x8051001F	Uma relação do tipo origem da assinatura digital foi encontrada, mas a parte de Origem da Assinatura Digital em si não foi. Para obter mais informações sobre esse tipo de relação, consulte o OPC.

Comentários

Se um pacote for modificado enquanto as Interfaces de Assinatura Digital de Empacotamento estiverem sendo usadas para assinar o pacote, a assinatura poderá falhar ou resultar em uma assinatura ou pacote inconsistente.

Suporte em versões anteriores do Windows

Não há suporte para esse método em versões do Windows anteriores ao Windows 7. Para obter mais informações, consulte Introdução com a API de Empacotamento e Atualização de Plataforma para Windows Vista.

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 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msopc.h