CryptCreateKeyIdentifierFromCSP 函数 (wincrypt.h)

  • 项目
重要 此 API 已弃用。 新的和现有的软件应开始使用 加密下一代 API。 Microsoft 可能会在将来的版本中删除此 API。
 
CryptCreateKeyIdentifierFromCSP 函数从加密服务提供程序创建密钥标识符， (CSP) 公钥CRYPT_INTEGER_BLOB。

此函数将 CSP 的 PUBLICKEYSTRUC 转换为 X.509CERT_PUBLIC_KEY_INFO 结构并对其进行编码。 然后，使用 SHA1 算法对编码结构进行 哈希处理 ，以获取密钥标识符。

语法

BOOL CryptCreateKeyIdentifierFromCSP(
  [in]      DWORD                dwCertEncodingType,
  [in]      LPCSTR               pszPubKeyOID,
  [in]      const PUBLICKEYSTRUC *pPubKeyStruc,
  [in]      DWORD                cbPubKeyStruc,
  [in]      DWORD                dwFlags,
  [in]      void                 *pvReserved,
  [out]     BYTE                 *pbHash,
  [in, out] DWORD                *pcbHash
);

参数

[in] dwCertEncodingType

指定使用的编码类型。 始终可以接受将证书和 消息编码类型 与按位 OR 操作组合在一起，如以下示例所示：

X509_ASN_ENCODING |PKCS_7_ASN_ENCODING

当前定义的编码类型包括：

  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING

[in] pszPubKeyOID

指向 OID) (公钥 对象标识符 的指针。 不为 NULL 的值将替代从 pPubKeyStruc 指向的结构的 aiKeyAlg 成员获取的默认 OID。 若要使用默认 OID，请将 pszPubKeyOID 设置为 NULL。

[in] pPubKeyStruc

指向 PUBLICKEYSTRUC 结构的指针。 默认情况下，pPubKeyStruc 指向的结构的 aiKeyAlg 成员用于查找公钥 OID。 当 pszPubKeyOID 的值不为 NULL 时，它将替代默认值。

[in] cbPubKeyStruc

PUBLICKEYSTRUC 的大小（以字节为单位）。

[in] dwFlags

保留以供将来使用，必须为零。

[in] pvReserved

保留以供将来使用，必须为 NULL。

[out] pbHash

指向缓冲区的指针，用于接收公钥和密钥标识符的 哈希 。

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

[in, out] pcbHash

指向 DWORD 的指针，指定 pbHash 参数指向的缓冲区的大小（以字节为单位）。 函数返回时， DWORD 包含缓冲区中存储的字节数。 使用 SHA1 哈希，所需缓冲区的长度为 20。

返回值

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

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

要求

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

另请参阅

CryptEnumKeyIdentifierProperties

CryptGetKeyIdentifierProperty

CryptSetKeyIdentifierProperty

密钥标识符函数