Funzione LsaGetLogonSessionData (ntsecapi.h)

  • Articolo

La funzione LsaGetLogonSessionData recupera informazioni su una sessione di accesso specificata.

Per recuperare informazioni su una sessione di accesso, il chiamante deve essere il proprietario della sessione o un amministratore di sistema locale.

Sintassi

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

Parametri

[in] LogonId

Specifica un puntatore a un LUID che identifica la sessione di accesso le cui informazioni verranno recuperate. Per informazioni sui valori validi per questo parametro, vedere Osservazioni.

[out] ppLogonSessionData

Indirizzo di un puntatore a una struttura SECURITY_LOGON_SESSION_DATA contenente informazioni sulla sessione di accesso specificata da LogonId. Questa struttura viene allocata dall'LSA. Quando le informazioni non sono più necessarie, chiamare la funzione LsaFreeReturnBuffer per liberare la memoria usata da questa struttura.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è un codice NTSTATUS che indica il motivo.

Commenti

Per ottenere identificatori di sessione di accesso validi che possono essere passati al parametro LogonId di questa funzione, chiamare la funzione LsaEnumerateLogonSessions .

Se LogonID specifica l'account LocalSystem (0x0:0x3e7), questa funzione restituisce zero per i dati della sessione di accesso recuperati in ppLogonSessionData. Il motivo è che l'account LocalSystem non viene connesso nel modo di accesso tipico. L'account LocalSystem è invece attivo dopo l'avvio del sistema.

Requisiti

   
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ntsecapi.h
Libreria Secur32.lib
DLL Secur32.dll