BCRYPT_PQDSA_PADDING_INFO structure

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

Указатель на буфер, содержащий строку контекста.

Может быть 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. В противном случае оно должно быть ненулевым целым числом меньше 256.

pszPrehashAlgId

A CNG hash algorithm identifier. Этот параметр указывает, будет ли использоваться чистый (например, ML-DSA) или предварительно хэш (например, HashML-DSA) вариант. Значение NULL указывает на использование чистого варианта. Чтобы использовать предварительно хэш-вариант, этот идентификатор должен ссылаться на утвержденный хэш-алгоритм: SHA-2, SHA-3 или 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

See also

BCryptSignHash

BCryptVerifySignature