Méthode IOpcDigitalSignature ::GetSignatureMethod (msopc.h)

Article
02/29/2024

Obtient la méthode de signature utilisée pour calculer la valeur dans l’élément SignatureValue du balisage de signature.

Syntaxe

HRESULT GetSignatureMethod(
  [out, retval] LPWSTR *signatureMethod
);

Paramètres

[out, retval] signatureMethod

Pointeur vers la méthode de signature.

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

Cette méthode alloue la mémoire utilisée par la chaîne retournée dans signatureMethod. Si la méthode réussit, appelez la fonction CoTaskMemFree pour libérer la mémoire.

Pour définir la méthode de signature avant la génération de la signature, appelez la méthode IOpcSigningOptions ::SetSignatureMethod .

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 . Les deux méthodes récupèrent la valeur définie par IOpcSigningOptions ::SetSignatureMethod.

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 Packaging.

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