cryptReleaseContext 函数 (wincrypt.h)

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

CryptReleaseContext 函数释放加密服务提供程序的句柄 (CSP) 和密钥容器。每次调用此函数时，CSP 上的引用计数都会减少 1。当引用计数达到零时，上下文将完全释放，并且应用程序中的任何函数都不能再使用它。

应用程序在完成 CSP 的使用后调用此函数。调用此函数后，释放的 CSP 句柄不再有效。此函数不会销毁密钥容器或密钥对。

语法

BOOL CryptReleaseContext(
  [in] HCRYPTPROV hProv,
  [in] DWORD      dwFlags
);

[in] hProv

加密服务提供程序 (CSP) 调用 CryptAcquireContext 创建的句柄。

[in] dwFlags

保留以供将来使用，必须为零。如果未将 dwFlags 设置为零，则此函数返回 FALSE ，但会释放 CSP。

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

如果函数失败，则返回值为零 (FALSE) 。有关扩展的错误信息，请调用 GetLastError。下表列出了一些可能的错误代码。

返回代码	说明
ERROR_BUSY	hProv 指定的 CSP 上下文当前正由另一个进程使用。
ERROR_INVALID_HANDLE	其中一个参数指定无效的句柄。
ERROR_INVALID_PARAMETER	其中一个参数包含无效的值。这通常是无效的指针。
NTE_BAD_FLAGS	dwFlags 参数为非零值。
NTE_BAD_UID	hProv 参数不包含有效的上下文句柄。

调用此函数后，CSP 会话已完成，使用 hProv 句柄创建的所有现有会话密钥和哈希对象将不再有效。实际上，在调用 CryptReleaseContext 之前，应通过调用 CryptDestroyKey 和 CryptDestroyHash 来销毁所有这些对象。