struttura BCRYPT_DSA_PARAMETER_HEADER_V2 (bcrypt.h)

  • Articolo

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

Vedi anche

BCryptGenerateKeyPair

BCryptSetProperty

Identificatori di proprietà primitive di crittografia