struttura BCRYPT_DSA_PARAMETER_HEADER_V2 (bcrypt.h)
La struttura BCRYPT_DSA_PARAMETER_HEADER_V2 viene usata come intestazione per un DSA ( Digital Signature Algorithm ) parameters BLOB contenente informazioni per la generazione di una chiave DSA. Questa struttura viene utilizzata con la proprietà BCRYPT_DSA_PARAMETERS nella funzione BCryptSetProperty .
Sintassi
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;
Members
cbLength
Dimensioni totali, in byte, di questa struttura e del buffer che segue immediatamente questa struttura in memoria.
dwMagic
Valore magic per la chiave.
Questo membro deve essere il valore seguente.
BCRYPT_DSA_PARAMETERS_MAGIC_V2 (0x324d5044)
cbKeyLength
Dimensione, in byte, della chiave a cui si applica questa struttura.
hashAlgorithm
Valore di enumerazione HASHALGORITHM_ENUM che specifica l'algoritmo hash da usare.
standardVersion
Valore di enumerazione DSAFIPSVERSION_ENUM che specifica lo standard FIPS (Federal Information Processing Standard) da applicare.
cbSeedLength
Lunghezza del valore di inizializzazione utilizzato per generare il numero primo q in byte.
cbGroupSize
Dimensioni del numero primo q. Attualmente, quando la chiave supera i 1024 bit di lunghezza, q è lunga 32 byte.
Count[4]
Numero di iterazioni eseguite per generare il numero primo q dal valore di inizializzazione. Per altre informazioni, vedere NIST Standard FIPS186-3.
Commenti
Quando si usa questa struttura in una chiamata BCryptSetProperty , per impostare i parametri per una chiave DSA creata in una chiamata BCryptGenerateKeyPair , (cbKeyLength*8) deve essere uguale a dwLength impostato in precedenza.
La struttura si applica alle chiavi DSA che superano la lunghezza di 1024 bit, ma sono minori o uguali a 3072 bit.
Questa struttura viene usata come intestazione per un buffer più grande. Il BLOB dei parametri DSA ha il formato seguente in memoria contigua. Il valore Seed, q, Modulus e Generator sono in formato big-endian.
BCRYPT_DSA_PARAMETER_HEADER_V2
Seed[cbSeedLength] // Big-endian.
q[cbGroupSize] // Big-endian.
Modulus[cbKeyLength] // Big-endian.
Generator[cbKeyLength] // Big-endian.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Intestazione | bcrypt.h |