Compartir a través de

Función LsaGetLogonSessionData (ntsecapi.h)

  • Artículo

La función LsaGetLogonSessionData recupera información sobre una sesión de inicio de sesión especificada.

Para recuperar información sobre una sesión de inicio de sesión, el autor de la llamada debe ser el propietario de la sesión o un administrador del sistema local.

Sintaxis

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

Parámetros

[in] LogonId

Especifica un puntero a un LUID que identifica la sesión de inicio de sesión cuya información se recuperará. Para obtener información sobre los valores válidos para este parámetro, vea Comentarios.

[out] ppLogonSessionData

Dirección de un puntero a una estructura de SECURITY_LOGON_SESSION_DATA que contiene información sobre la sesión de inicio de sesión especificada por LogonId. La LSA asigna esta estructura. Cuando la información ya no sea necesaria, llame a la función LsaFreeReturnBuffer para liberar la memoria usada por esta estructura.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es STATUS_SUCCESS.

Si se produce un error en la función, el valor devuelto es un código NTSTATUS que indica el motivo.

Comentarios

Para obtener identificadores de sesión de inicio de sesión válidos que se pueden pasar al parámetro LogonId de esta función, llame a la función LsaEnumerateLogonSessions .

Si LogonID especifica la cuenta LocalSystem (0x0:0x3e7), esta función devuelve cero para los datos de sesión de inicio de sesión recuperados en ppLogonSessionData. El motivo es que la cuenta localSystem no inicia sesión de la manera típica de inicio de sesión. En su lugar, la cuenta localSystem está activa después de que se inicie el sistema.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ntsecapi.h
Library Secur32.lib
Archivo DLL Secur32.dll