CryptSignMessage 函数 (wincrypt.h)
CryptSignMessage 函数创建指定内容的哈希,对哈希进行签名,然后对原始消息内容和已签名哈希进行编码。
语法
BOOL CryptSignMessage(
[in] PCRYPT_SIGN_MESSAGE_PARA pSignPara,
[in] BOOL fDetachedSignature,
[in] DWORD cToBeSigned,
[in] const BYTE * [] rgpbToBeSigned,
[in] DWORD [] rgcbToBeSigned,
[out] BYTE *pbSignedBlob,
[in, out] DWORD *pcbSignedBlob
);
参数
[in] pSignPara
指向包含签名参数 的CRYPT_SIGN_MESSAGE_PARA 结构的指针。
[in] fDetachedSignature
如果这是一个分离的签名,则为 TRUE。 否则为 FALSE。 如果此参数设置为 TRUE,则只有带符号哈希以 pbSignedBlob 进行编码。 否则, rgpbToBeSigned 和带符号哈希都进行编码。
[in] cToBeSigned
rgpbToBeSigned 和 rgcbToBeSigned 中的数组元素数的计数。 除非 fDetachedSignature 设置为 TRUE,否则此参数必须设置为 1。
[in] rgpbToBeSigned
指向包含要签名的内容的缓冲区的指针数组。
[in] rgcbToBeSigned
rgpbToBeSigned 中指向的内容缓冲区的大小数组(以字节为单位)。
[out] pbSignedBlob
指向用于接收编码的带符号哈希(如果 fDetachedSignature 为 TRUE)的缓冲区的指针;如果 fDetachedSignature 为 FALSE,则指向编码内容和带符号哈希的指针。
此参数可以为 NULL ,用于设置此信息的大小,以便进行内存分配。 有关详细信息,请参阅 检索长度未知的数据。
[in, out] pcbSignedBlob
指向指定 pbSignedBlob 缓冲区大小(以字节为单位)的 DWORD 的指针。 函数返回时,此变量包含带符号和编码消息的大小(以字节为单位)。
返回值
如果函数成功,则返回值为非零 (TRUE) 。
如果函数失败,则返回值为零, (FALSE) 。
有关扩展的错误信息,请调用 GetLastError。
下面列出了 GetLastError 函数最常返回的错误代码。
返回代码 | 说明 |
---|---|
|
如果 pbSignedBlob 参数指定的缓冲区不够大,无法容纳返回的数据,则函数将设置ERROR_MORE_DATA代码,并将所需的缓冲区大小(以字节为单位)存储在 由ERROR_MORE_DATA Blob 指向的变量中。 |
|
消息编码类型无效。 目前仅支持PKCS_7_ASN_ENCODING。 *pSignPara 中的 cbSize 无效。 |
|
*pSignPara 中的 pSigningCert 没有 CERT_KEY_PROV_INFO_PROP_ID 或 CERT_KEY_CONTEXT_PROP_ID 属性。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | wincrypt.h |
Library | Crypt32.lib |
DLL | Crypt32.dll |