Функция 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 завершает контекст безопасности и освобождает связанные ресурсы.

Вызывающий объект должен вызывать эту функцию для контекста безопасности, когда этот контекст безопасности больше не нужен. Это верно, если контекст безопасности является частичным, неполным, отклоненным или неудачным. После успешного удаления контекста безопасности дальнейшее использование этого контекста безопасности запрещено, а дескриптор больше недействителен.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header sspi.h (включая Security.h)
Библиотека Secur32.lib
DLL Secur32.dll

См. также раздел

AcceptSecurityContext (Общие)

InitializeSecurityContext (General)

Функции SSPI