[New - Windows NT]
[New - Windows 95, OEM Service Release 2]
CryptDestroyHash功能会破坏由【马】参数引用的散列对象。一旦哈希对象被破坏,它将不能再被使用,并且它的句柄从那时起是没有用的。
当应用程序完成后,所有散列对象都应使用CryptDestroyHash函数进行销毁。
BOOL CRYPTFUNC CryptDestroyHash(
HCRYPTHASH【马】 | |
); |
参数
【马】
[in]要销毁的哈希对象的句柄。
备注
当哈希对象被破坏时,许多CSP将擦除CSP中保存哈希对象的内存。然后CSP内存被释放。
在CryptCreateHash和CryptDestroyHash之间应该有一对一的对应关系。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要检索扩展错误信息,请使用GetLastError功能。
下表列出了GetLastError功能最常返回的错误代码。由“NTE”开头的错误代码由您使用的特定CSP生成。
错误 | 描述 |
ERROR_BUSY | 由【马】指定的散列对象正在被其他进程使用。 |
ERROR_INVALID_HANDLE | 其中一个参数指定一个无效句柄。 |
ERROR_INVALID_PARAMETER | 其中一个参数包含无效值。这通常是一个非法的指针。 |
NTE_BAD_ALGID | 【马】句柄指定此CSP不支持的算法。 |
NTE_BAD_HASH | 由【马】参数指定的散列对象无效。 |
NTE_BAD_UID | 创建哈希对象时指定的CSP上下文无法找到。 |
例
请参阅CryptSignHash功能中的“示例”部分。
也可以看看