Fonction CryptMsgCountersign (wincrypt.h)
La fonction CryptMsgCountersign contresigne une signature existante dans un message. Les contresignatures sont utilisées pour signer le hachage chiffré d’une signature existante du message. Les contre-signatures peuvent être utilisées à diverses fins, y compris l’horodatage d’un message.
Syntaxe
BOOL CryptMsgCountersign(
[in, out] HCRYPTMSG hCryptMsg,
[in] DWORD dwIndex,
[in] DWORD cCountersigners,
[in] PCMSG_SIGNER_ENCODE_INFO rgCountersigners
);
Paramètres
[in, out] hCryptMsg
Handle de message de chiffrement à utiliser.
[in] dwIndex
Index de base zéro du signataire dans le message signé ou signé et enveloppé à contresigner.
[in] cCountersigners
Nombre de contre-expéditeurs dans le tableau rgCountersigners .
[in] rgCountersigners
Tableau des structures CMSG_SIGNER_ENCODE_INFO des contre-expéditeurs.
Valeur retournée
Si la fonction réussit, la fonction retourne une valeur différente de zéro (TRUE).
Si la fonction échoue, elle retourne zéro (FALSE). Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Une erreur peut être propagée à partir de CryptMsgCountersignEncoded.
Les codes d’erreur suivants sont retournés le plus souvent.
| Code de retour | Description |
|---|---|
|
Un ou plusieurs arguments ne sont pas valides. |
|
Mémoire insuffisante. |
|
La zone spécifiée n’est pas suffisamment grande pour contenir les données retournées. |
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 | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | wincrypt.h |
| Bibliothèque | Crypt32.lib |
| DLL | Crypt32.dll |
Voir aussi
CryptMsgVerifyCountersignatureEncoded