Partager via


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
E_INVALIDARG
Un ou plusieurs arguments ne sont pas valides.
E_OUTOFMEMORY
Mémoire insuffisante.
ERROR_MORE_DATA
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

CryptMsgCountersignEncoded

CryptMsgVerifyCountersignatureEncoded

Fonctions de message de bas niveau

Fonctions de message simplifiées