structure CRYPT_KEY_SIGN_MESSAGE_PARA (wincrypt.h)

La structure CRYPT_KEY_SIGN_MESSAGE_PARA contient des informations sur le fournisseur de services de chiffrement (CSP) et les algorithmes utilisés pour signer un message.

Syntaxe

typedef struct _CRYPT_KEY_SIGN_MESSAGE_PARA {
  DWORD                      cbSize;
  DWORD                      dwMsgAndCertEncodingType;
  union {
    HCRYPTPROV        hCryptProv;
    NCRYPT_KEY_HANDLE hNCryptKey;
  } DUMMYUNIONNAME;
  DWORD                      dwKeySpec;
  CRYPT_ALGORITHM_IDENTIFIER HashAlgorithm;
  void                       *pvHashAuxInfo;
  CRYPT_ALGORITHM_IDENTIFIER PubKeyAlgorithm;
} CRYPT_KEY_SIGN_MESSAGE_PARA, *PCRYPT_KEY_SIGN_MESSAGE_PARA;

Membres

cbSize

Taille, en octets, de cette structure de données.

dwMsgAndCertEncodingType

Spécifie le type d’encodage de message et de certificat utilisé. Il peut s’agir d’une combinaison d’une ou plusieurs des valeurs suivantes.

Valeur	Signification
X509_ASN_ENCODING	Spécifie l’encodage du certificat X.509 .
PKCS_7_ASN_ENCODING	Spécifie l’encodage des messages PKCS 7.

DUMMYUNIONNAME

DUMMYUNIONNAME.hCryptProv

Handle du fournisseur de solutions cloud à utiliser pour signer le message. La fonction CryptAcquireContext est appelée pour obtenir ce handle.

DUMMYUNIONNAME.hNCryptKey

Handle de l’API de chiffrement : CNG (Next Generation) CSP à utiliser pour signer le message. Les algorithmes de signature CNG sont uniquement pris en charge dans les fonctions CNG.

dwKeySpec

Identifie le type de clé privée à utiliser pour signer le message. Il doit s’agir de l’une des valeurs suivantes. Ce membre est ignoré si une clé CNG est passée dans le membre hNCryptKey .

Valeur	Signification
AT_KEYEXCHANGE	Utilisez la clé d’échange de clé.
AT_SIGNATURE	Utilisez la clé de signature numérique.

HashAlgorithm

Structure CRYPT_ALGORITHM_IDENTIFIER qui spécifie l’algorithme à utiliser pour générer le hachage du message. Il doit s’agir d’un algorithme de hachage.

pvHashAuxInfo

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

PubKeyAlgorithm

Structure CRYPT_ALGORITHM_IDENTIFIER qui spécifie l’algorithme à utiliser pour signer le message. Il doit s’agir d’une clé publique ou d’un algorithme de signature.

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