IOpcSigningOptions ::SetSignatureMethod, méthode (msopc.h)

Article
02/29/2024

Définit la méthode de signature à utiliser pour calculer et chiffrer la valeur de hachage de l’élément SignedInfo , qui sera contenue dans l’élément SignatureValue de la signature.

Syntaxe

HRESULT SetSignatureMethod(
  [in] LPCWSTR signatureMethod
);

Paramètres

[in] signatureMethod

Méthode de signature à utiliser.

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	Le paramètre signatureMethod est NULL.

Remarques

Pour accéder à la méthode de signature avant la génération de la signature, appelez IOpcSigningOptions ::GetSignatureMethod. Pour accéder à la méthode de signature une fois la signature générée, appelez la méthode IOpcDigitalSignature ::GetSignatureMethod .

Important Une méthode de signature valide doit être définie avant que la signature ne soit générée en appelant la méthode IOpcDigitalSignatureManager ::Sign .

Lorsqu’une signature est générée, elle est sérialisée en tant que balisage de signature. La méthode de signature est utilisée pour calculer la valeur dans l’élément SignatureValue dans le balisage de signature.

Lorsqu’une signature est validée, la méthode de signature est utilisée pour recalculer cette valeur, et la valeur recalculée est comparée à la valeur dans l’élément SignatureValue dans le balisage de signature.

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