Método IXpsSignature::Verify (xpsdigitalsignature.h)
Verifica a assinatura em relação a um certificado X.509 especificado.
Sintaxe
HRESULT Verify(
[in] const CERT_CONTEXT *x509Certificate,
[out, retval] XPS_SIGNATURE_STATUS *sigStatus
);
Parâmetros
[in] x509Certificate
A estrutura CERT_CONTEXT que contém o certificado X.509 que será usado para verificação.
Se a assinatura não estiver incompleta ou incompatíveis, esse certificado será usado apenas para validar se os dados assinados no pacote XPS estão intactos. O certificado não será usado para executar nenhuma outra verificação. Antes de usar o certificado, espera-se que o aplicativo verifique a cadeia de confiança e quaisquer outros requisitos.
[out, retval] sigStatus
O valor XPS_SIGNATURE_STATUS que descreve os resultados da verificação.
Retornar valor
O método retorna um HRESULT. Os valores possíveis incluem, mas não se limitam, aqueles na tabela a seguir. Para obter valores retornados que não estão listados nesta tabela, consulte Erros de API de Assinatura Digital XPS e Erros de Documento XPS.
| Código de retorno | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
x509Certificate ou sigStatus é NULL. |
|
A interface não está conectada ao gerenciador de assinaturas. |
Comentários
Esse método detecta a assinatura status na ordem especificada na seção 10.2.1.2 da Especificação de Papel XML. A sequência de detecção é a seguinte: incompatível, incompleta, quebrada, questionável e, por fim, válida. Isso significa que, se, por exemplo, uma assinatura for considerada incompatíveis, nenhum resumo será calculado se a assinatura também estiver desfeita.
Para obter mais informações sobre os diferentes tipos de status de assinatura que podem ser detectados por esse método, consulte XPS_SIGNATURE_STATUS.
Requisitos
| 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 | xpsdigitalsignature.h |