BCRYPT_PQDSA_KEY_BLOB structure

Эта структура используется для импорта и экспорта ключей для алгоритмов post-Quantum Digital Signature (PQDSA). The BCRYPT_PQDSA_KEY_BLOB structure is used as a header for a Post-Quantum Digital Signature algorithm (PQDSA) public key (byte-encoded encapsulation key) or private keyBLOB in memory.

Syntax

typedef struct _BCRYPT_PQDSA_KEY_BLOB {
  ULONG dwMagic;
  ULONG cbParameterSet;                                   // Byte size of parameterSet[]
  ULONG cbKey;                                            // Byte size of key[]
  // WCHAR parameterSet[cbParameterSet / sizeof(WCHAR)];  // Including \0 terminator
  // BYTE key[cbKey];                                     // Key material
} BCRYPT_PQDSA_KEY_BLOB, *PBCRYPT_PQDSA_KEY_BLOB;

Fields

dwMagic

The dwMagic field is a 4-byte value that indicates the format of the key being used. Определены следующие значения:

cbParameterSet

Длина буфера в байтах parameterSet непосредственно после структуры. Этот буфер содержит строку Юникода, завершающую значение NULL, которая определяет набор параметров ключа. В настоящее время поддерживаются следующие значения:

cbKey

The length, in bytes, of the buffer key directly following parameterSet. Этот размер является статическим и зависит от используемого формата ключа и набора параметров.

Remarks

Потребители алгоритмов post-Quantum Digital Signature будут использовать то же подмножество API BCrypt, что и существующие алгоритмы цифровой подписи (не пост-квантовые), поддерживаемые CNG, для выполнения операций, поддерживаемых алгоритмами. These are:

• Algorithm handle manipulation: BCryptOpenAlgorithmProvider, BCryptCloseAlgorithmProvider
• Key management: BCryptGenerateKeyPair, BCryptImportKeyPair, BCryptExportKey, BCryptDestroyKey, BCryptFinalizeKeyPair
• Signature generation/verification: BCryptSignHash, BCryptVerifySignature
• Updating/Querying properties: BCryptGetProperty, BCryptSetProperty

Requirements