通过

BCRYPT_PQDSA_PADDING_INFO structure

Note

某些信息与预发行产品有关，该产品在商业发布之前可能会进行大幅修改。 Microsoft对此处提供的信息不作任何明示或暗示的保证。 本主题中所述的功能在 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

指向包含上下文字符串的缓冲区的指针。

可能是 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

Requirement Value
最低支持的客户端 Windows 预览体验成员（内部版本 27843）： 开始对 ML-DSA 的支持。 [仅限桌面应用]
支持的最低服务器 Windows 预览体验成员（内部版本 27843）： 开始对 ML-DSA 的支持。 [仅限桌面应用]
Header bcrypt.h

See also

BCryptSignHash

BCryptVerifySignature