Partager via

structure CRYPT_KEY_SIGN_MESSAGE_PARA (wincrypt.h)

  • Article

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