Compartilhar via


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

Cria sessões de logon.

A sessão de logon é identificada por uma ID de logon exclusiva ( LUID) atribuída à sessão de logon.

Sintaxe

LSA_CREATE_LOGON_SESSION LsaCreateLogonSession;

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

Parâmetros

[in] LogonId

Ponteiro para uma estrutura LUID a ser atribuída à nova sessão de logon. Um pacote de autenticação chama AllocateLocallyUniqueId para gerar essa ID.

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 o valor a seguir ou um dos valores retornados da função de política LSA.

Código de retorno Descrição
STATUS_LOGON_SESSION_COLLISION
A ID de logon especificada já está em uso por outra sessão de logon.
 

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

Comentários

Se um pacote de autenticação criar sessões de logon desnecessárias ao determinar se deseja autenticar o usuário, ele deverá excluí-lo chamando DeleteLogonSession. Se a autenticação falhar, o pacote de autenticação deverá excluir todas as sessões de logon relacionadas.

Como as sessões de logon usam memória no kernel, é importante excluir sessões de logon não utilizadas ou descartadas.

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

DeleteLogonSession

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE