IXpsSignature ::Verify, méthode (xpsdigitalsignature.h)

Article
08/28/2023

Vérifie la signature par rapport à un certificat X.509 spécifié.

Syntaxe

HRESULT Verify(
  [in]          const CERT_CONTEXT   *x509Certificate,
  [out, retval] XPS_SIGNATURE_STATUS *sigStatus
);

Paramètres

[in] x509Certificate

Le CERT_CONTEXT structure qui contient le certificat X.509 qui sera utilisé pour la vérification.

Si la signature n’est pas incomplète ou non conforme, ce certificat sera utilisé uniquement pour vérifier que les données signées dans le package XPS sont intactes. Le certificat ne sera pas utilisé pour effectuer d’autres vérifications. Avant d’utiliser le certificat, l’application doit vérifier la chaîne de confiance et toute autre configuration requise.

[out, retval] sigStatus

Valeur XPS_SIGNATURE_STATUS qui décrit les résultats de la vérification.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles de la table qui suit. Pour connaître les valeurs de retour qui ne sont pas répertoriées dans ce tableau, consultez Erreurs de l’API signature numérique XPS et Erreurs de document XPS.

Code de retour	Description
S_OK	S_OK
E_POINTER	x509Certificate ou sigStatus a la valeur NULL.
E_UNEXPECTED	L’interface n’est pas connectée au gestionnaire de signatures.

Remarques

Cette méthode détecte la signature status dans l’ordre spécifié dans la section 10.2.1.2 de la spécification de papier XML. La séquence de détection est la suivante : non conforme, incomplète, rompue, douteuse et, enfin, valide. Cela signifie que si, par exemple, une signature est jugée non conforme, aucune synthèse n’est calculée si la signature est également rompue.

Pour plus d’informations sur les différents types d’états de signature qui peuvent être détectés par cette méthode, consultez XPS_SIGNATURE_STATUS.

Configuration requise


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	xpsdigitalsignature.h