LSA_DELETE_LOGON_SESSION funzione di callback (ntsecpkg.h)

  • Articolo

Pulisce tutte le sessioni di accesso create durante la determinazione se le informazioni di autenticazione di un utente sono legittime.

Se l'autenticazione ha esito negativo, il pacchetto di autenticazione deve eliminare tutte le sessioni di accesso correlate.

Sintassi

LSA_DELETE_LOGON_SESSION LsaDeleteLogonSession;

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

Parametri

[in] LogonId

Puntatore a una struttura LUID contenente l'ID sessione di accesso da eliminare.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è STATUS_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice NTSTATUS, che può essere uno dei valori seguenti o uno dei valori restituiti della funzione Criteri LSA.

Codice restituito Descrizione
STATUS_BAD_LOGON_SESSION_STATE
 La sessione di accesso specificata ha un valore di conteggio dei riferimenti che impedisce l'eliminazione. Si tratta di un problema grave, causato sia dal sistema operativo che dal pacchetto di autenticazione credendo che abbiano autorità sulla sessione di accesso.
STATUS_NO_SUCH_LOGON_SESSION
 Impossibile trovare la sessione di accesso specificata.
 

La funzione LsaNtStatusToWinError converte un codice NTSTATUS in un codice di errore di Windows.

Commenti

Poiché le sessioni di accesso usano memoria nel kernel, tutte le sessioni di accesso inutilizzate o rimosse devono essere eliminate. Tuttavia, le sessioni di accesso non devono essere eliminate dopo che è stato restituito un ID di accesso per la sessione. Dopo che l'LSA è stato assegnato un ID di accesso (ad esempio, come risultato di una chiamata LsaApLogonUser ), l'LSA presuppone che sia responsabile della sessione di accesso e lo eliminerà quando il sistema operativo non lo necessita più. A questo punto, LSA chiama LsaApLogonTerminated per notificare al pacchetto di autenticazione che la sessione è stata eliminata.

Al contrario, i pacchetti di autenticazione non vengono notificati quando viene eliminata una sessione di accesso con DeleteLogonSession.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ntsecpkg.h

Vedi anche

CreateLogonSession

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE