BCRYPT_DSA_PARAMETER_HEADER_V2 structure (bcrypt.h)
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 |