Fonction CryptGetMessageSignerCount (wincrypt.h)
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 |
|---|---|
|
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 |