PFN_CMSG_EXPORT_KEY_TRANS回调函数 (wincrypt.h)

PFN_CMSG_EXPORT_KEY_TRANS 回调函数对信封邮件的密钥传输收件人的内容加密密钥进行加密和导出。 可以使用 CryptoAPI对象标识符(OID)安装 PFN_CMSG_EXPORT_KEY_TRANS。 当 dwMsgType 参数设置为 CMSG_ENVELOPED时,CryptMsgOpenToEncode 函数调用此函数。

语法

PFN_CMSG_EXPORT_KEY_TRANS PfnCmsgExportKeyTrans;

BOOL PfnCmsgExportKeyTrans(
  [in]      PCMSG_CONTENT_ENCRYPT_INFO pContentEncryptInfo,
  [in]      PCMSG_KEY_TRANS_RECIPIENT_ENCODE_INFO pKeyTransEncodeInfo,
  [in, out] PCMSG_KEY_TRANS_ENCRYPT_INFO pKeyTransEncryptInfo,
  [in]      DWORD dwFlags,
            void *pvReserved
)
{...}

参数

[in] pContentEncryptInfo

指向包含内容加密密钥的 CMSG_CONTENT_ENCRYPT_INFO 结构的指针。

[in] pKeyTransEncodeInfo

指向 CMSG_KEY_TRANS_RECIPIENT_ENCODE_INFO 结构的指针,该结构指定用于加密内容加密密钥的收件人公钥。

[in, out] pKeyTransEncryptInfo

指向包含加密内容加密密钥的 CMSG_KEY_TRANS_ENCRYPT_INFO 结构的指针。

[in] dwFlags

不使用此值。 将其设置为零。

pvReserved

此值保留。 将其设置为 NULL

返回值

如果函数成功,则返回值为非零(TRUE)。

如果函数失败,则返回值为零(FALSE)。 有关扩展错误信息,请调用 GetLastError

言论

PFN_CMSG_EXPORT_KEY_TRANS 函数必须更新由 pKeyTransEncryptInfo 参数指向的 CMSG_KEY_TRANS_ENCRYPT_INFO 结构的 EncryptedKey 成员。 此函数必须使用 pfnAllocpfnFreepContentEncryptInfo 参数指向 CMSG_CONTENT_ENCRYPT_INFO 结构的成员来管理加密密钥的内存分配。

可以使用 OID 支持函数 部署此回调函数。 Wincrypt.h 为此定义以下常量。

必须为 CAPI1 密钥和加密 API 定义不同的回调函数:下一代(CNG)密钥。 这两个函数具有相同的签名,但使用不同的 OID。 调用哪个函数取决于 pContentEncryptInfo 参数指向的 CMSG_CONTENT_ENCRYPT_INFO 结构的 fCNG 成员的值。 下表显示了回调函数与 fCNG 成员的值之间的关系。

fCNG 值 不断 定义
CMSG_OID_EXPORT_KEY_TRANS_FUNC或CMSG_OID_CAPI1_EXPORT_KEY_TRANS_FUNC “CryptMsgDllExportKeyTrans”
CMSG_OID_CNG_EXPORT_KEY_TRANS_FUNC “CryptMsgDllCNGExportKeyTrans”

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 wincrypt.h