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

另请参阅

解码信封数据