PFN_CRYPT_EXPORT_PUBLIC_KEY_INFO_EX2_FUNC回调函数 (wincrypt.h)

  • 项目

PFN_CRYPT_EXPORT_PUBLIC_KEY_INFO_EX2_FUNC回调函数由 CryptExportPublicKeyInfoEx 调用，以导出公钥 BLOB 并对其进行编码。

语法

PFN_CRYPT_EXPORT_PUBLIC_KEY_INFO_EX2_FUNC PfnCryptExportPublicKeyInfoEx2Func;

BOOL PfnCryptExportPublicKeyInfoEx2Func(
  [in]            NCRYPT_KEY_HANDLE hNCryptKey,
  [in]            DWORD dwCertEncodingType,
  [in]            LPSTR pszPublicKeyObjId,
  [in]            DWORD dwFlags,
  [in, optional]  void *pvAuxInfo,
  [out, optional] PCERT_PUBLIC_KEY_INFO pInfo,
  [in, out]       DWORD *pcbInfo
)
{...}

参数

[in] hNCryptKey

导出公钥信息时要使用的 加密服务提供程序 (CSP) 句柄。 此句柄必须是使用 NCryptOpenKey 函数创建的NCRYPT_KEY_HANDLE句柄。

[in] dwCertEncodingType

一个 值，该值指定使用的编码类型。 始终可以通过将证书和 消息编码类型 与按位 OR 操作结合使用来指定它们，如以下示例所示：

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING

当前定义的编码类型为：

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pszPublicKeyObjId

指向包含 公钥算法的字符串的指针。

[in] dwFlags

一个 值，该值指示如何导出公钥信息。 这可以是零。

[in, optional] pvAuxInfo

此参数保留供将来使用，必须设置为 NULL。

[out, optional] pInfo

指向 CERT_PUBLIC_KEY_INFO 结构的指针，用于接收要导出的公钥信息。

此参数可以为 NULL ，用于设置此信息的大小，以便进行内存分配。 有关详细信息，请参阅 检索长度未知的数据。

[in, out] pcbInfo

指向 DWORD 的指针，其中包含 pInfo 参数指向的缓冲区的大小（以字节为单位）。 函数返回时， DWORD 包含缓冲区中存储的字节数。

注意 处理缓冲区中返回的数据时，应用程序需要使用返回的数据的实际大小。 实际大小可以略小于输入时指定的缓冲区的大小。 (输入时，缓冲区大小通常指定得足够大，以确保缓冲区中容纳可能的最大输出数据。) 输出时，此参数指向的变量将更新为反映复制到缓冲区的数据的实际大小。
 

返回值

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

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

如果此回调函数不支持签名算法，则必须返回 FALSE 并使用 ERROR_NOT_SUPPORTED调用 SetLastError。

注解

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

常数 定义
CRYPT_OID_EXPORT_PUBLIC_KEY_INFO_EX2_FUNC “CryptDllExportPublicKeyInfoEx2”

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wincrypt.h