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

Artículo
02/29/2024

Valida una firma de paquete especificada mediante un certificado especificado.

Sintaxis

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

Parámetros

[in] signature

Puntero de interfaz IOpcDigitalSignature que representa la firma que se va a validar.

[in] certificate

Puntero a una estructura de CERT_CONTEXT que contiene un certificado que se usa para validar la firma.

[out, retval] validationResult

Valor que describe el resultado de la comprobación de validación.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	Al menos uno de los parámetros signature, certificate y validationResult es NULL.

Comentarios

Este método no realiza comprobaciones de seguridad en un certificado de infraestructura de clave pública X.509; el autor de la llamada debe realizar las comprobaciones de revocación, expiración, cadena de certificados y todas las demás comprobaciones necesarias.

Este método comprueba que la firma especificada (entidades firmadas y el marcado de firma) no se ha modificado desde que se generó la firma, pero no valida la identidad del firmante.

Importante El autor de la llamada debe validar la identidad del firmante.

Si hay errores en una firma de paquete, es posible que algunos de estos errores no se expongan hasta que se llame a este método.

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para más información, consulte la Introducción con la API de empaquetado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h