Compartilhar via


LSA_DELETE_LOGON_SESSION função de retorno de chamada (ntsecpkg.h)

Limpa as sessões de logon criadas ao determinar se as informações de autenticação de um usuário são legítimas.

Se a autenticação falhar, o pacote de autenticação deverá excluir todas as sessões de logon relacionadas.

Sintaxe

LSA_DELETE_LOGON_SESSION LsaDeleteLogonSession;

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

Parâmetros

[in] LogonId

Ponteiro para uma estrutura LUID que contém a ID da sessão de logon a ser excluída.

Retornar valor

Se a função for bem-sucedida, o valor retornado será STATUS_SUCCESS.

Se a função falhar, o valor retornado será um código NTSTATUS, que pode ser um dos valores a seguir ou um dos valores retornados da função de política LSA.

Código de retorno Descrição
STATUS_BAD_LOGON_SESSION_STATE
A sessão de logon especificada tem um valor de contagem de referência que impede que ela seja excluída. Esse é um problema sério, causado pelo sistema operacional e pelo pacote de autenticação que acreditam ter autoridade sobre a sessão de logon.
STATUS_NO_SUCH_LOGON_SESSION
Não foi possível encontrar a sessão de logon especificada.
 

A função LsaNtStatusToWinError converte um código NTSTATUS em um código de erro do Windows.

Comentários

Como as sessões de logon usam memória no kernel, todas as sessões de logon não usadas ou descartadas devem ser excluídas. No entanto, as sessões de logon não devem ser excluídas depois que uma ID de logon para a sessão tiver sido retornada à LSA. Depois que a LSA receber uma ID de logon (por exemplo, como resultado de uma chamada LsaApLogonUser ), a LSA pressupõe que ela seja responsável pela sessão de logon e a excluirá quando o sistema operacional não precisar mais dela. Neste momento, a LSA chama LsaApLogonTerminated para notificar o pacote de autenticação de que a sessão foi excluída.

Por outro lado, os pacotes de autenticação não são notificados quando uma sessão de logon é excluída com DeleteLogonSession.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ntsecpkg.h

Confira também

CreateLogonSession

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE