cryptDecryptMessage 函数 (wincrypt.h)

  • 项目

CryptDecryptMessage 函数对消息进行解码和解密。

语法

BOOL CryptDecryptMessage(
  [in]                PCRYPT_DECRYPT_MESSAGE_PARA pDecryptPara,
  [in]                const BYTE                  *pbEncryptedBlob,
  [in]                DWORD                       cbEncryptedBlob,
  [out, optional]     BYTE                        *pbDecrypted,
  [in, out, optional] DWORD                       *pcbDecrypted,
  [out, optional]     PCCERT_CONTEXT              *ppXchgCert
);

参数

[in] pDecryptPara

指向包含解密参数 的CRYPT_DECRYPT_MESSAGE_PARA 结构的指针。

[in] pbEncryptedBlob

指向包含要解密的 编码 和 加密 消息的缓冲区的指针。

[in] cbEncryptedBlob

已编码和加密消息的大小（以字节为单位）。

[out, optional] pbDecrypted

指向接收解密消息的缓冲区的指针。

若要设置此信息的大小以用于内存分配，此参数可以为 NULL。 如果此参数为 NULL，则不会返回解密的消息。 有关详细信息，请参阅 检索未知长度的数据。

[in, out, optional] pcbDecrypted

指向 DWORD 的指针，指定 pbDecrypted 参数指向的缓冲区的大小（以字节为单位）。 当函数返回时，此变量包含复制到 pbDecrypted 的解密消息的大小（以字节为单位）。

注意 处理 pbDecrypted 缓冲区中返回的数据时，应用程序必须使用返回的数据的实际大小。 实际大小可以略小于输入时 在“输入时”的“码号” 中指定缓冲区的大小。 在输入时，缓冲区大小通常指定得足够大，以确保缓冲区中容纳可能的最大输出数据。 输出时， DWORD 将更新为复制到缓冲区的数据的实际大小。
 

[out, optional] ppXchgCert

指向证书CERT_CONTEXT结构的指针，该结构对应于解密消息所需的私钥。 若要指示函数不应返回用于解密的 证书上下文 ，请将此参数设置为 NULL。

返回值

如果函数成功，则函数) 返回非零 (TRUE 。

如果函数失败，它将返回零 (FALSE) 。 有关扩展的错误信息，请调用 GetLastError。

注意 调用 CryptImportKey 和 CryptDecrypt 时的错误可能会传播到此函数。
 
GetLastError 函数最常返回以下错误代码。
返回代码 说明
ERROR_MORE_DATA
 如果 pbDecrypted 参数指定的缓冲区不够大，无法容纳返回的数据，则函数将设置ERROR_MORE_DATA代码，并将所需的缓冲区大小（以字节为单位）存储在 由ed 指向的变量中。
E_INVALIDARG
 无效的消息和 证书编码类型。 目前仅支持PKCS_7_ASN_ENCODING和X509_ASN_ENCODING_TYPE。 *pDecryptPara 中的 cbSize 无效。
CRYPT_E_UNEXPECTED_MSG_TYPE
 不是 信封加密 消息。
NTE_BAD_ALGID
 消息是使用未知或不受支持的算法加密的。
CRYPT_E_NO_DECRYPT_CERT
 找不到具有用于解密的 私钥 属性的证书。
 

如果函数失败， GetLastError 可能会返回 抽象语法表示法 One (ASN.1) 编码/解码错误。 有关这些错误的信息，请参阅 ASN.1 编码/解码返回值。

备注

如果为 pbDecrypted 传递 NULL，且未为 null，则为在 ppXchgCert 中传递的地址返回 NULL;否则，返回指向CERT_CONTEXT的指针。 对于成功解密的消息，指向 CERT_CONTEXT 的指针指向用于解密消息的 证书上下文 。 必须通过调用 CertFreeCertificateContext 来释放它。 如果函数失败， ppXchgCert 处的值将设置为 NULL。

示例

有关使用此函数的示例，请参阅 示例 C 程序：使用 CryptEncryptMessage 和 CryptDecryptMessage。

要求

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

另请参阅

CryptDecryptAndVerifyMessageSignature

简化的消息函数