Udostępnij przez


BCRYPT_PQDSA_PADDING_INFO structure

Note

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed jego wydaniem komercyjnym. Firma Microsoft nie udziela żadnych gwarancji, wyraźnych ani domniemanych, w odniesieniu do podanych tutaj informacji. Funkcja opisana w tym temacie jest dostępna w wersjach wstępnych programu Windows Insider Preview.

The BCRYPT_PQDSA_PADDING_INFO structure is used to specify the padding scheme for Post-Quantum Digital Signature algorithms (PQDSA).

Syntax

typedef struct _BCRYPT_PQDSA_PADDING_INFO {
  PUCHAR    pbCtx;
  ULONG     cbCtx;
  LPCWSTR   pszPrehashAlgId;
} BCRYPT_PQDSA_PADDING_INFO;

Fields

pbCtx

Wskaźnik do buforu zawierającego ciąg kontekstu.

Może to być NULL. If pbCtx is NULL, then cbCtx must be set to 0.

cbCtx

The size, in bytes, of the context string pointed to by pbCtx. Its value must be 0 if pbCtx is NULL. W przeciwnym razie musi być liczbą całkowitą spoza zera mniejszą niż 256.

pszPrehashAlgId

A CNG hash algorithm identifier. Ten parametr wskazuje, czy będzie używany wariant czysty (np. ML-DSA) czy pre-hash (np. HashML-DSA). Wartość NULL wskazuje użycie czystego wariantu. Aby użyć wariantu wstępnego skrótu, ten identyfikator musi odwoływać się do zatwierdzonego algorytmu wyznaczania wartości skrótu: SHA-2, SHA-3 lub SHAKE.

Remarks

For many PQDSA signatures, the use of BCRYPT_PQDSA_PADDING_INFO is not required. Using NULLpPaddingInfo in calls to BCryptSignHash and BCryptVerifySignature is equivalent to using pure variant with an empty context string.

Requirements

Requirement Value
Minimalny obsługiwany klient Niejawni testerzy systemu Windows (kompilacja 27843): Rozpoczyna się obsługa ML-DSA. [Tylko aplikacje klasyczne]
Minimalna obsługiwana wersja serwera Niejawni testerzy systemu Windows (kompilacja 27843): Rozpoczyna się obsługa ML-DSA. [Tylko aplikacje klasyczne]
Header bcrypt.h

See also

BCryptSignHash

BCryptVerifySignature