PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY回调函数 (wincrypt.h)
PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY回调函数 (CEK) 导入已解密的内容加密密钥。 可以使用加密 API 安装 PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY 函数:下一代 (CNG) 对象标识符 (OID) 。
语法
PFN_CMSG_CNG_IMPORT_CONTENT_ENCRYPT_KEY PfnCmsgCngImportContentEncryptKey;
BOOL PfnCmsgCngImportContentEncryptKey(
[in, out] PCMSG_CNG_CONTENT_DECRYPT_INFO pCNGContentDecryptInfo,
[in] DWORD dwFlags,
void *pvReserved
)
{...}
参数
[in, out] pCNGContentDecryptInfo
指向要使用导入的 CEK 更新 的CMSG_CNG_CONTENT_DECRYPT_INFO 结构的指针。 此结构包含传递给 CryptMsgControl 函数的所有相关信息。
[in] dwFlags
此参数为保留参数。 将其设置为零。
pvReserved
此参数为保留参数。 将其设置为 NULL。
返回值
如果函数成功,则返回值为非零 (TRUE) 。
如果函数失败,则返回值为零, (FALSE) 。 有关扩展的错误信息,请调用 GetLastError。
如果此回调函数不支持密钥加密算法,则必须返回 FALSE ,并使用 ERROR_NOT_SUPPORTED 调用 SetLastError 。
注解
CryptMsgControl 函数对其 dwCtrlType 参数指定的以下操作调用此函数:
- CMSG_CTRL_DECRYPT
- CMSG_CTRL_KEY_TRANS_DECRYPT
- CMSG_CTRL_KEY_AGREE_DECRYPT
可以使用 OID 支持函数 来部署此回调函数。 Wincrypt.h 为此定义了以下常量。
一直 | 定义 |
---|---|
CMSG_OID_CNG_IMPORT_CONTENT_ENCRYPT_KEY_FUNC | “CryptMsgDllCNGImportContentEncryptKey” |
示例
有关部署 OID 可安装的回调函数的示例,请参阅 扩展 CryptoAPI 功能。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | wincrypt.h |