Méthode IWSDSignatureProperty ::GetSignedInfoHash (wsdbase.h)

Article
03/13/2024

Obtient le hachage d’une signature de message.

Syntaxe

HRESULT GetSignedInfoHash(
  [out]     BYTE  *pbSignedInfoHash,
  [in, out] DWORD *pdwHashSize
);

Paramètres

[out] pbSignedInfoHash

Pointeur vers une mémoire tampon qui sera remplie avec le hachage de la signature du message.

[in, out] pdwHashSize

En entrée, la taille de pbSignedInfoHash en octets. Lors de la sortie, pdwHashSize contient la taille réelle de la mémoire tampon qui a été écrite.

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants.

Code de retour	Description
S_OK	La méthode a réussi.
E_NOTAVAIL	Le message n’est pas signé.
HRESULT_FROM_WIN32(ERROR_MORE_DATA)	pbSignedInfoHash n’est pas assez grand pour contenir les informations. pdwHashSize spécifie désormais la taille de mémoire tampon requise.

Remarques

Il s’agit du hachage du <nœud SignedInfo> . Le <nœud xml SignedInfo> contient les hachages SHA1 des différentes parties de la signature qui doivent être incluses dans la signature. La signature de message XML finale est calculée en signant le hachage du <nœud SignedInfo> avec la clé privée du certificat de signature.

Si NULL est transmis à pbSignedInfoHash, GetSignedInfoHash retourne la taille de la mémoire tampon à allouer dans le paramètre pdwHashSize .

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	wsdbase.h (inclure Wsdapi.h)
DLL	Wsdapi.dll

Voir aussi

IWSDSignatureProperty

Partager via