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 |