Функция SspiDeleteSecurityContextAsync (sspi.h)

Статья
08/26/2023

Функция SspiDeleteSecurityContextAsync удаляет локальные структуры данных, связанные с указанным контекстом безопасности , инициированные предыдущим вызовом функции SspiInitializeSecurityContextAsync или функции SspiAcceptSecurityContextAsync .

Синтаксис

SECURITY_STATUS SspiDeleteSecurityContextAsync(
  SspiAsyncContext *AsyncContext,
  PCtxtHandle      phContext
);

Параметры

AsyncContext

Контекст асинхронного вызова.

phContext

Дескриптор удаляемого контекста безопасности.

Возвращаемое значение

Возвращает SEC_E_OK , если асинхронный запрос на удаление контекста безопасности был успешно поставлен в очередь для выполнения. В противном случае возвращается ошибка, созданная при попытке поместить ее в очередь. Чтобы получить состояние операции, используйте SspiGetAsyncCallStatus.

SspiGetAsyncCallStatus возвращает SEC_E_OK по завершении. В противном случае он может вернуть SEC_I_ASYNC_CALL_PENDING , если вызов все еще выполняется, или один из приведенных ниже кодов ошибок.

Код возврата	Описание
SEC_E_INVALID_HANDLE	Дескриптор, переданный функции, недопустим.

При завершении асинхронного вызова вызывающие абоненты могут отказаться от получения уведомления, избегая настройки обратного вызова для нового SspiAsyncContext или удалив обратный вызов с помощью SspiSetAsyncNotifyCallback с параметром NULL. При отказе вызывающий объект должен освободить контекст с помощью SspiFreeAsyncContext сразу после вызова SspiDeleteSecurityContextAsync, если только контекст не предназначен для повторного использования.

Функция SspiDeleteSecurityContextAsync завершает контекст безопасности и освобождает связанные ресурсы.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 версии 1607 [только драйверы в режиме ядра]
Минимальная версия сервера	Windows Server 2016 [только драйверы в режиме ядра]
Верхняя часть	sspi.h