функция обратного вызова LSA_DELETE_LOGON_SESSION (ntsecpkg.h)

Статья
02/29/2024

Очищает все сеансы входа, созданные при определении допустимости сведений о проверке подлинности пользователя.

Если проверка подлинности завершается сбоем, пакет проверки подлинности должен удалить все связанные сеансы входа.

Синтаксис

LSA_DELETE_LOGON_SESSION LsaDeleteLogonSession;

NTSTATUS LsaDeleteLogonSession(
  [in] PLUID LogonId
)
{...}

Параметры

[in] LogonId

Указатель на структуру LUID , содержащую идентификатор удаляемого сеанса входа.

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

Если функция выполняется успешно, возвращаемое значение будет STATUS_SUCCESS.

Если функция завершается ошибкой, возвращаемым значением является код NTSTATUS, который может быть одним из следующих значений или одним из возвращаемых значений функции политики LSA.

Код возврата	Описание
STATUS_BAD_LOGON_SESSION_STATE	Указанный сеанс входа в систему имеет значение счетчика ссылок, которое предотвращает его удаление. Это серьезная проблема, вызванная тем, что операционная система и пакет проверки подлинности считают, что они имеют право на сеанс входа.
STATUS_NO_SUCH_LOGON_SESSION	Не удалось найти указанный сеанс входа.

Код возврата

Описание

STATUS_BAD_LOGON_SESSION_STATE

Указанный сеанс входа в систему имеет значение счетчика ссылок, которое предотвращает его удаление. Это серьезная проблема, вызванная тем, что операционная система и пакет проверки подлинности считают, что они имеют право на сеанс входа.

STATUS_NO_SUCH_LOGON_SESSION

Не удалось найти указанный сеанс входа.

Функция LsaNtStatusToWinError преобразует код NTSTATUS в код ошибки Windows.

Так как сеансы входа используют память в ядре, все неиспользуемые или отмененные сеансы входа должны быть удалены. Однако сеансы входа в систему не следует удалять после возвращения идентификатора входа для сеанса в LSA. После того как LSA будет предоставлен идентификатор входа (например, в результате вызова LsaApLogonUser ), LSA предполагает, что отвечает за сеанс входа и удалит его, когда он больше не нужен операционной системе. В настоящее время LSA вызывает LsaApLogonTerminated , чтобы уведомить пакет проверки подлинности об удалении сеанса.

В отличие от этого, пакеты проверки подлинности не получают уведомления при удалении сеанса входа с помощью DeleteLogonSession.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	ntsecpkg.h

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

CreateLogonSession

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE