BCRYPT_PQDSA_KEY_BLOB structure

Diese Struktur wird verwendet, um Schlüssel für Post-Quantum Digital Signature Algorithmen (PQDSA) zu importieren und zu exportieren. 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. Die folgenden Werte sind definiert:

cbParameterSet

Die Länge des Puffers parameterSet in Bytes direkt nach der Struktur. Dieser Puffer enthält eine mit Null beendete Unicode-Zeichenfolge, die den Parametersatz des Schlüssels identifiziert. Die folgenden Werte werden derzeit unterstützt:

cbKey

The length, in bytes, of the buffer key directly following parameterSet. Diese Größe ist statisch und hängt vom verwendeten Schlüsselformat und vom verwendeten Parameter ab.

Remarks

Die Verbraucher von Post-Quantum Digital Signature-Algorithmen verwenden dieselbe Teilmenge der BCrypt-API wie die vorhandenen (nicht post-Quantum) digitalen Signaturalgorithmen, die von CNG unterstützt werden, um die Vorgänge auszuführen, die die Algorithmen unterstützen. 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