BCRYPT_DSA_PARAMETER_HEADER_V2 structure (bcrypt.h)

  • Article

La structure BCRYPT_DSA_PARAMETER_HEADER_V2 est utilisée comme en-tête pour un objet BLOB de paramètres DSA (Digital Signature Algorithm) contenant des informations pour générer une clé DSA. Cette structure est utilisée avec la propriété BCRYPT_DSA_PARAMETERS dans la fonction BCryptSetProperty .

Syntaxe

typedef struct _BCRYPT_DSA_PARAMETER_HEADER_V2 {
  ULONG               cbLength;
  ULONG               dwMagic;
  ULONG               cbKeyLength;
  HASHALGORITHM_ENUM  hashAlgorithm;
  DSAFIPSVERSION_ENUM standardVersion;
  ULONG               cbSeedLength;
  ULONG               cbGroupSize;
  UCHAR               Count[4];
} BCRYPT_DSA_PARAMETER_HEADER_V2;

Membres

cbLength

Taille totale, en octets, de cette structure et de la mémoire tampon qui suit immédiatement cette structure en mémoire.

dwMagic

Valeur magique de la clé.

Ce membre doit être la valeur suivante.

BCRYPT_DSA_PARAMETERS_MAGIC_V2 (0x324d5044)

cbKeyLength

Taille, en octets, de la clé à laquelle cette structure s’applique.

hashAlgorithm

Valeur d’énumération HASHALGORITHM_ENUM qui spécifie l’algorithme de hachage à utiliser.

standardVersion

Valeur d’énumération DSAFIPSVERSION_ENUM qui spécifie la norme FIPS (Federal Information Processing Standard) à appliquer.

cbSeedLength

Longueur de la valeur de départ utilisée pour générer le nombre premier q en octets.

cbGroupSize

Taille du nombre premier q. Actuellement, lorsque la clé dépasse 1 024 bits, q a une longueur de 32 octets.

Count[4]

Nombre d’itérations effectuées pour générer le nombre premier q à partir de la valeur initiale. Pour plus d’informations, consultez la norme NIST FIPS186-3.

Remarques

Lorsque vous utilisez cette structure dans un appel BCryptSetProperty , pour définir les paramètres d’une clé DSA créée dans un appel BCryptGenerateKeyPair , (cbKeyLength*8) doit être égal à dwLength précédemment défini.

La structure s’applique aux clés DSA qui dépassent 1 024 bits, mais qui sont inférieures ou égales à 3 072 bits.

Cette structure est utilisée comme en-tête pour une mémoire tampon plus grande. L’objet blob de paramètres DSA a le format suivant en mémoire contiguë. Les valeurs Seed, q, Modulus et Generator sont au format big-endian.


BCRYPT_DSA_PARAMETER_HEADER_V2
Seed[cbSeedLength]      // Big-endian.
q[cbGroupSize]          // Big-endian.
Modulus[cbKeyLength]    // Big-endian.
Generator[cbKeyLength]  // Big-endian.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
En-tête bcrypt.h

Voir aussi

BCryptGenerateKeyPair

BCryptSetProperty

Identificateurs de propriété primitive de chiffrement