Partager via


LSA_DELETE_LOGON_SESSION fonction de rappel (ntsecpkg.h)

Nettoie toutes les sessions d’ouverture de session créées tout en déterminant si les informations d’authentification d’un utilisateur sont légitimes.

Si l’authentification échoue, le package d’authentification doit supprimer toutes les sessions d’ouverture de session associées.

Syntaxe

LSA_DELETE_LOGON_SESSION LsaDeleteLogonSession;

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

Paramètres

[in] LogonId

Pointeur vers une structure LUID contenant l’ID de session de session de session à supprimer.

Valeur retournée

Si la fonction réussit, la valeur de retour est STATUS_SUCCESS.

Si la fonction échoue, la valeur de retour est un code NTSTATUS, qui peut être l’une des valeurs suivantes ou l’une des valeurs de retour de la fonction de stratégie LSA.

Code de retour Description
STATUS_BAD_LOGON_SESSION_STATE
La session d’ouverture de session spécifiée a une valeur de nombre de références qui l’empêche d’être supprimée. Il s’agit d’un problème grave, dû au fait que le système d’exploitation et le package d’authentification croient avoir autorité sur la session d’ouverture de session.
STATUS_NO_SUCH_LOGON_SESSION
La session d’ouverture de session spécifiée est introuvable.
 

La fonction LsaNtStatusToWinError convertit un code NTSTATUS en code d’erreur Windows.

Remarques

Étant donné que les sessions d’ouverture de session utilisent de la mémoire dans le noyau, toutes les sessions d’ouverture de session inutilisées ou ignorées doivent être supprimées. Toutefois, les sessions d’ouverture de session ne doivent pas être supprimées une fois qu’un ID d’ouverture de session a été retourné à la LSA. Une fois que le LSA a reçu un ID d’ouverture de session (par exemple, à la suite d’un appel LsaApLogonUser ), le LSA suppose qu’il est responsable de la session d’ouverture de session et le supprimera lorsque le système d’exploitation n’en aura plus besoin. À ce stade, LSA appelle LsaApLogonTerminated pour informer le package d’authentification que la session a été supprimée.

En revanche, les packages d’authentification ne sont pas avertis lorsqu’une session d’ouverture de session est supprimée avec DeleteLogonSession.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête ntsecpkg.h

Voir aussi

CreateLogonSession

LSA_DISPATCH_TABLE

LSA_SECPKG_FUNCTION_TABLE