cryptSIPPutSignedDataMsg 函数 (mssip.h)

CryptSIPPutSignedDataMsg 函数将验证码签名存储在目标文件中。

语法

BOOL CryptSIPPutSignedDataMsg(
  [in]  SIP_SUBJECTINFO *pSubjectInfo,
  [in]  DWORD           dwEncodingType,
  [out] DWORD           *pdwIndex,
  [in]  DWORD           cbSignedDataMsg,
  [in]  BYTE            *pbSignedDataMsg
);

参数

[in] pSubjectInfo

指向包含有关邮件主题信息的 SIP_SUBJECTINFO 结构的指针。

[in] dwEncodingType

消息的编码类型。 这可以是以下一个或多个值的组合。

含义
PKCS_7_ASN_ENCODING
65536 (0x10000)
指定 PKCS #7 消息编码。
X509_ASN_ENCODING
1 (0x1)
指定 X.509 证书编码。

[out] pdwIndex

指向消息索引的指针。

[in] cbSignedDataMsg

pbSignedDataMsg 参数指向的缓冲区的长度(以字节为单位)。

[in] pbSignedDataMsg

指向包含消息的缓冲区的指针。

返回值

如果函数成功,则函数返回 TRUE

如果函数失败,则返回 FALSE。 有关扩展的错误信息,请调用 GetLastError。 下面是一些可能的错误代码。

返回代码 说明
ERROR_BAD_FORMAT
使用者接口包 (SIP) 的指定数据或文件格式无效。
ERROR_INVALID_PARAMETER
可能出于以下原因返回此代码:
  • pSubjectInfoNULL
  • pdwIndexNULL
  • pbSignedDataMsgNULL
  • cbSignedDataMsg 参数的值小于 1。
  • [SIP_SUBJECTINFO] (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo) 结构。 [SIP_SUBJECTINFO] (/windows/desktop/api/mssip/ns-mssip-sip_subjectinfo) 结构。
TRUST_E_SUBJECT_FORM_UNKNOWN
指定的主题类型无效。

注解

每个主题类型使用其数据的不同子集进行哈希计算,并且需要不同的存储和检索过程。 因此,每个主题类型都具有唯一的 SIP 规范。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 mssip.h
Library Crypt32.lib
DLL Crypt32.dll

另请参阅

CryptSIPGetSignedDataMsg

CryptSIPRemoveSignedDataMsg