CryptDestroyHash 函数 (wincrypt.h)

重要此 API 已弃用。新的和现有的软件应开始使用加密下一代 API。 Microsoft 可能会在将来的版本中删除此 API。

CryptDestroyHash 函数销毁 hHash 参数引用的哈希对象。销毁哈希对象后，将无法再使用该对象。

为了帮助确保安全性，我们建议在使用哈希对象后销毁它们。

语法

BOOL CryptDestroyHash(
  [in] HCRYPTHASH hHash
);

[in] hHash

要销毁的哈希对象的句柄。

如果该函数成功，则返回值为非零值。

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

“NTE”开头的错误代码由你正在使用的特定加密服务提供程序 (CSP) 生成。一些可能的错误代码随之而来。

销毁哈希对象时，许多 CSP 会覆盖保存哈希对象的 CSP 中的内存。然后释放 CSP 内存。

调用 CryptCreateHash 和 CryptDestroyHash 之间应该有一对一的对应关系。

必须先销毁使用特定 CSP 创建的所有哈希对象，然后才能使用 CryptReleaseContext 函数释放该 CSP 句柄。

有关使用 CryptDestroyHash 函数的示例，请参阅示例 C 程序：创建和哈希处理会话密钥。