IOpcDigitalSignatureManager ::Validate, méthode (msopc.h)

Article
03/13/2024

Valide une signature de package spécifiée à l’aide d’un certificat spécifié.

Syntaxe

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

Paramètres

[in] signature

Pointeur d’interface IOpcDigitalSignature qui représente la signature à valider.

[in] certificate

Pointeur vers une structure CERT_CONTEXT qui contient un certificat utilisé pour valider la signature.

[out, retval] validationResult

Valeur qui décrit le résultat de la validation case activée.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
E_POINTER	Au moins un des paramètres signature, certificat et validationResult est NULL.

Remarques

Cette méthode n’effectue pas de vérifications de sécurité sur un certificat d’infrastructure de clé publique X.509 ; l’appelant doit effectuer les vérifications de révocation, d’expiration, de chaîne de certificats et de toutes les autres vérifications nécessaires.

Cette méthode vérifie que la signature spécifiée (entités signées et balisage de signature) n’a pas été modifiée depuis la génération de la signature, mais ne valide pas l’identité du signataire.

Important L’appelant doit valider l’identité du signataire.

S’il existe des erreurs dans une signature de package, certaines de ces erreurs peuvent ne pas être exposées tant que cette méthode n’est pas appelée.

Cohérence de thread

Les objets d’empaquetage ne sont pas thread-safe.

Pour plus d’informations, consultez la Prise en main avec l’API d’empaquetage.

Configuration requise

Condition requise	Valeur
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	msopc.h