Método IOpcDigitalSignatureManager::Validate (msopc.h)

Artigo
03/13/2024

Valida uma assinatura de pacote especificada usando um certificado especificado.

Sintaxe

HRESULT Validate(
  [in]          IOpcDigitalSignature            *signature,
  [in]          const CERT_CONTEXT              *certificate,
  [out, retval] OPC_SIGNATURE_VALIDATION_RESULT *validationResult
);

Parâmetros

[in] signature

Um ponteiro de interface IOpcDigitalSignature que representa a assinatura a ser validada.

[in] certificate

Um ponteiro para uma estrutura CERT_CONTEXT que contém um certificado usado para validar a assinatura.

[out, retval] validationResult

Um valor que descreve o resultado do marcar de validação.

Retornar valor

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

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	Pelo menos um dos parâmetros signature, certificate e validationResult é NULL.

Comentários

Esse método não executa verificações de segurança em um certificado de infraestrutura de chave pública X.509; o chamador deve executar as verificações de revogação, expiração, cadeia de certificados e todas as outras verificações necessárias.

Esse método 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.

Se houver erros em uma assinatura de pacote, alguns desses erros poderão não ser expostos até que esse método seja chamado.

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