BCryptSignHash 函数创建哈希值的签名。
语法
NTSTATUS BCryptSignHash(
[in] BCRYPT_KEY_HANDLE hKey,
[in, optional] VOID *pPaddingInfo,
[in] PUCHAR pbInput,
[in] ULONG cbInput,
[out] PUCHAR pbOutput,
[in] ULONG cbOutput,
[out] ULONG *pcbResult,
[in] ULONG dwFlags
);
参数
[in] hKey
用于对哈希进行签名的密钥的句柄。
[in, optional] pPaddingInfo
指向包含填充信息的结构的指针。 此参数指向的结构的实际类型取决于 dwFlags 参数的值。 此参数仅用于非对称密钥，否则必须为 NULL 其他参数。
pPaddingInfo 必须为 NULL LMS 和 XMSS，因为生成密钥和输入以外的签名不需要其他信息。
[in] pbInput
指向包含要签名的哈希值的缓冲区的指针。 cbInput 参数包含此缓冲区的大小。
[in] cbInput
要签名的 pbInput 缓冲区中的字节数。
[out] pbOutput
要接收此函数生成的签名的缓冲区的地址。 cbOutput 参数包含此缓冲区的大小。
如果此参数为 NULL此参数，此函数将计算签名所需的大小，并返回 由Result 参数指向的位置的大小。
[in] cbOutput
pbOutput 缓冲区的大小（以字节为单位）。 如果 pbOutput 参数为 NULL.，则忽略此参数。
[out] pcbResult
指向 ULONG 变量的指针，该变量接收复制到 pbOutput 缓冲区的字节数。
如果 pbOutput 为 NULL，则会接收签名所需的大小（以字节为单位）。
[in] dwFlags
一组标志，用于修改此函数的行为。 允许的标志集取决于 hKey 参数指定的键类型。
对于 LMS 和 XMSS，dwFlags 必须为零，因为生成密钥和输入以外的签名不需要其他信息。
这可以是以下值之一：
| 价值 | 意义 |
|---|---|
| BCRYPT_PAD_PKCS1 | 使用 PKCS1 填充方案。 pPaddingInfo 参数是指向BCRYPT_PKCS1_PADDING_INFO结构的指针。 |
| BCRYPT_PAD_PQDSA | 将 PQ 填充方案用于 ML-DSA 或 SLH-DSA。
pPaddingInfo 参数是指向BCRYPT_PQDSA_PADDING_INFO结构的指针。 注意： 如果使用预哈希 ML-DSA 变体，则必须设置此设置。 |
| BCRYPT_PAD_PSS | 使用概率签名方案 （PSS） 填充方案。 pPaddingInfo 参数是指向BCRYPT_PSS_PADDING_INFO结构的指针。 |
返回值
返回一个状态代码，指示函数的成功或失败。
可能的返回代码包括但不限于以下代码：
| 返回代码 | 描述 |
|---|---|
| STATUS_SUCCESS | 函数成功。 |
| STATUS_INVALID_HANDLE | hKey 参数指定的密钥句柄无效。 |
| STATUS_NOT_SUPPORTED | 用于创建 hKey 参数指定的密钥句柄的算法提供程序不是签名算法。 |
| STATUS_NO_MEMORY | 发生内存分配失败。 |
| STATUS_BUFFER_TOO_SMALL | cbOutput 参数指定的内存大小不足以保存签名。 |
言论
此函数将使用指定密钥加密哈希值以创建签名。
若要稍后验证签名是否有效，请使用相同的键和原始数据的相同哈希调用 BCryptVerifySignature 函数。
根据提供程序支持的处理器模式，可以从用户模式或内核模式调用 BCryptSignHash 。 内核模式调用方可以在 PASSIVE_LEVELIRQL 或 DISPATCH_LEVEL IRQL 上执行。 如果当前 IRQL 级别 DISPATCH_LEVEL，则 hKey 参数中提供的句柄必须派生自使用 BCRYPT_PROV_DISPATCH 标志打开的提供程序返回的算法句柄，并且传递给 BCryptSignHash 函数的任何指针都必须引用非分页（或锁定）内存。
若要在内核模式下调用此函数，请使用 Cng.lib，这是驱动程序开发工具包（DDK）的一部分。
Windows Server 2008 和 Windows Vista： 若要在内核模式下调用此函数，请使用 Ksecdd.lib。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista [桌面应用 |UWP 应用] |
| 支持的最低服务器 | Windows Server 2008 [桌面应用 |UWP 应用] |
| 目标平台 | 窗户 |
| 标头 | bcrypt.h |
| 图书馆 | Bcrypt.lib |
| DLL | Bcrypt.dll |