Método IXpsSignature::Verify (xpsdigitalsignature.h)
Comprueba la firma con un certificado X.509 especificado.
Sintaxis
HRESULT Verify(
[in] const CERT_CONTEXT *x509Certificate,
[out, retval] XPS_SIGNATURE_STATUS *sigStatus
);
Parámetros
[in] x509Certificate
Estructura CERT_CONTEXT que contiene el certificado X.509 que se usará para la comprobación.
Si la firma no está incompleta o no es compatible, este certificado solo se usará para validar que los datos firmados del paquete XPS están intactos. El certificado no se usará para realizar ninguna otra comprobación. Antes de usar el certificado, se espera que la aplicación compruebe la cadena de confianza y cualquier otro requisito.
[out, retval] sigStatus
Valor XPS_SIGNATURE_STATUS que describe los resultados de la comprobación.
Valor devuelto
El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener los valores devueltos que no aparecen en esta tabla, consulte Errores de XPS Digital Signature API y Errores de documento XPS.
| Código devuelto | Descripción |
|---|---|
|
El método se ha llevado a cabo de forma correcta. |
|
x509Certificate o sigStatus es NULL. |
|
La interfaz no está conectada al administrador de firmas. |
Comentarios
Este método detecta el estado de la firma en el orden especificado en la sección 10.2.1.2 de la especificación de papel XML. La secuencia de detección es la siguiente: no conforme, incompleto, roto, interrogable y, por último, válido. Esto significa que si, por ejemplo, se detecta que una firma no es compatible, no se calculará ningún resumen si la firma también se interrumpe.
Para obtener más información sobre los diferentes tipos de estados de firma que puede detectar este método, vea XPS_SIGNATURE_STATUS.
Requisitos
| 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 | xpsdigitalsignature.h |