deleteSecurityContext 函数 (sspi.h)

DeleteSecurityContext 函数删除与指定安全上下文关联的本地数据结构,该上下文由先前调用 InitializeSecurityContext (General) 函数或 AcceptSecurityContext (General) 函数启动。

语法

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY DeleteSecurityContext(
  [in] PCtxtHandle phContext
);

参数

[in] phContext

要删除的安全上下文的句柄。

警告

不要在 对 DeleteSecurityContext 的并发调用中使用相同的上下文句柄。 安全服务提供程序中的 API 实现不是线程安全的。

返回值

如果函数成功或句柄已被删除,则返回值 SEC_E_OK

如果函数失败,则返回值可能是以下错误代码:

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

注解

DeleteSecurityContext 函数终止安全上下文并释放关联的资源。

当不再需要安全上下文时,调用方必须为安全上下文调用此函数。 如果安全上下文部分、不完整、拒绝或失败,则为 true。 成功删除安全上下文后,不允许进一步使用该安全上下文,并且句柄不再有效。

要求

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

另请参阅

AcceptSecurityContext (常规)

InitializeSecurityContext (常规)

SSPI 函数