FreeCredentialsHandle 函数 (sspi.h)

  • 项目

FreeCredentialsHandle 函数通知安全系统不再需要凭据。 应用程序调用此函数以释放在调用 AcquireCredentialsHandle (General) 函数后获取的 凭据句柄 ，以释放与凭据关联的任何上下文句柄。 删除对此凭据集的所有引用后，可以删除凭据本身。

未能释放凭据句柄将导致内存泄漏。

语法

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY FreeCredentialsHandle(
  [in] PCredHandle phCredential
);

参数

[in] phCredential

指向使用 AcquireCredentialsHandle (General) 函数获取的 CredHandle 句柄的指针。

返回值

如果函数成功，该函数将返回SEC_E_OK。

如果该函数失败，它将返回以下错误代码。

返回代码 说明
SEC_E_INVALID_HANDLE
 传递给函数的句柄无效。

要求

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

另请参阅

AcquireCredentialsHandle (General)

SSPI 函数