LsaGetLogonSessionData, fonction (ntsecapi.h)

La fonction LsaGetLogonSessionData récupère des informations sur une session d’ouverture de session spécifiée.

Pour récupérer des informations sur une session d’ouverture de session, l’appelant doit être le propriétaire de la session ou un administrateur système local.

Syntaxe

NTSTATUS LsaGetLogonSessionData(
  [in]  PLUID                        LogonId,
  [out] PSECURITY_LOGON_SESSION_DATA *ppLogonSessionData
);

Paramètres

[in] LogonId

Spécifie un pointeur vers un LUID qui identifie la session d’ouverture de session dont les informations seront récupérées. Pour plus d’informations sur les valeurs valides pour ce paramètre, consultez Remarques.

[out] ppLogonSessionData

Adresse d’un pointeur vers une structure SECURITY_LOGON_SESSION_DATA contenant des informations sur la session d’ouverture de session spécifiée par LogonId. Cette structure est allouée par LSA. Lorsque les informations ne sont plus nécessaires, appelez la fonction LsaFreeReturnBuffer pour libérer la mémoire utilisée par cette structure.

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 indiquant la raison.

Notes

Pour obtenir des identificateurs de session d’ouverture de session valides qui peuvent être passés au paramètre LogonId de cette fonction, appelez la fonction LsaEnumerateLogonSessions .

Si LogonID spécifie le compte LocalSystem (0x0:0x3e7), cette fonction retourne zéro pour les données de session d’ouverture de session récupérées dans ppLogonSessionData. La raison en est que le compte LocalSystem n’est pas connecté de manière classique. Au lieu de cela, le compte LocalSystem est actif après le démarrage du système.

Spécifications

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	ntsecapi.h
Bibliothèque	Secur32.lib
DLL	Secur32.dll