CMSG_CTRL_VERIFY_SIGNATURE_EX_PARA structure (wincrypt.h)

Article
08/27/2023

La structure CMSG_CTRL_VERIFY_SIGNATURE_EX_PARA contient des informations utilisées pour vérifier une signature de message. Il contient l’index du signataire et la clé publique du signataire. La clé publique du signataire peut être la structure CERT_PUBLIC_KEY_INFO du signataire, le contexte de certificat ou le contexte de chaîne.

Syntaxe

typedef struct _CMSG_CTRL_VERIFY_SIGNATURE_EX_PARA {
  DWORD             cbSize;
  HCRYPTPROV_LEGACY hCryptProv;
  DWORD             dwSignerIndex;
  DWORD             dwSignerType;
  void              *pvSigner;
} CMSG_CTRL_VERIFY_SIGNATURE_EX_PARA, *PCMSG_CTRL_VERIFY_SIGNATURE_EX_PARA;

Membres

cbSize

Taille, en octets, de cette structure.

hCryptProv

Ce membre n’est pas utilisé et doit être défini sur NULL.

Windows Server 2003 et Windows XP : Handle du fournisseur de chiffrement utilisé pour vérifier la signature. Si la valeur est NULL, le fournisseur de chiffrement spécifié dans CryptMsgOpenToDecode est utilisé. Si hCryptProv dans CryptMsgOpenToDecode a également la valeur NULL, le fournisseur par défaut en fonction de l’identificateur d’objet de clé publique (OID) du signataire est utilisé. Le type de données de ce membre est HCRYPTPROV.

dwSignerIndex

Index du signataire dans le message.

dwSignerType

Structure qui contient les informations du signataire. Le tableau suivant présente les valeurs prédéfinies et les structures indiquées.

Valeur	Signification
CMSG_VERIFY_SIGNER_PUBKEY	CERT_PUBLIC_KEY_INFO
CMSG_VERIFY_SIGNER_CERT	CERT_CONTEXT
CMSG_VERIFY_SIGNER_CHAIN	CERT_CHAIN_CONTEXT
CMSG_VERIFY_SIGNER_NULL	NULL

pvSigner

Pointeur vers une structure CERT_PUBLIC_KEY_INFO , un contexte de certificat, un contexte de chaîne ou NULL selon la valeur de dwSignerType.

Remarques

Si dwSignerType est CMSG_VERIFY_SIGNER_NULL, la signature doit contenir uniquement les octets de hachage non chiffrés.

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]
En-tête	wincrypt.h

Share via