Fonction CryptGetMessageSignerCount (wincrypt.h)

  • Article

La fonction CryptGetMessageSignerCount retourne le nombre de signataires d’un message signé.

Notes

Cette fonction peut renvoyer un nombre de signataires en double et ne peut donc pas suffire à éviter les attaques. Nous vous recommandons d’utiliser le champ sid (SignerIdentifier) de SignerInfo pour identifier les signataires en double dans un message.

Syntaxe

LONG CryptGetMessageSignerCount(
  [in] DWORD      dwMsgEncodingType,
  [in] const BYTE *pbSignedBlob,
  [in] DWORD      cbSignedBlob
);

Paramètres

[in] dwMsgEncodingType

Spécifie le type d’encodage utilisé. Il est toujours acceptable de spécifier les types d’encodage de certificat et de message en les combinant avec une opération OR au niveau du bit, comme illustré dans l’exemple suivant :

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

Les types d’encodage actuellement définis sont les suivants :

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pbSignedBlob

Pointeur vers une mémoire tampon contenant le message signé.

[in] cbSignedBlob

Taille, en octets, du message signé.

Valeur retournée

Retourne le nombre de signataires d’un message signé, zéro lorsqu’il n’y a pas de signataires et moins un (–1) pour une erreur.

Pour obtenir des informations d’erreur étendues, appelez GetLastError. Le code d’erreur suivant est le plus souvent retourné.

Code de retour Description
E_INVALIDARG
 Type d’encodage de message non valide. Actuellement, seule PKCS_7_ASN_ENCODING est prise en charge.
 

Si la fonction échoue, GetLastError peut renvoyer une erreur d’encodage/décodage asN.1 ( Abstract Syntax Notation One ). Pour plus d’informations sur ces erreurs, consultez Valeurs de retour d’encodage/décodage ASN.1.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wincrypt.h
Bibliothèque Crypt32.lib
DLL Crypt32.dll

Voir aussi

CryptVerifyMessageSignature

Fonctions de message simplifiées