Função LsaGetLogonSessionData (ntsecapi.h)

A função LsaGetLogonSessionData recupera informações sobre uma sessão de logon especificada.

Para recuperar informações sobre uma sessão de logon, o chamador deve ser o proprietário da sessão ou um administrador do sistema local.

Sintaxe

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

Parâmetros

[in] LogonId

Especifica um ponteiro para um LUID que identifica a sessão de logon cujas informações serão recuperadas. Para obter informações sobre valores válidos para esse parâmetro, consulte Comentários.

[out] ppLogonSessionData

Endereço de um ponteiro para uma estrutura SECURITY_LOGON_SESSION_DATA que contém informações sobre a sessão de logon especificada por LogonId. Essa estrutura é alocada pela LSA. Quando as informações não forem mais necessárias, chame a função LsaFreeReturnBuffer para liberar a memória usada por essa estrutura.

Valor retornado

Se a função for bem-sucedida, o valor retornado será STATUS_SUCCESS.

Se a função falhar, o valor retornado será um código NTSTATUS que indica o motivo.

Comentários

Para obter identificadores de sessão de logon válidos que podem ser passados para o parâmetro LogonId dessa função, chame a função LsaEnumerateLogonSessions .

Se LogonID especificar a conta LocalSystem (0x0:0x3e7), essa função retornará zero para os dados de sessão de logon recuperados em ppLogonSessionData. O motivo é que a conta LocalSystem não é conectada da maneira típica de logon. Em vez disso, a conta LocalSystem está ativa após o início do sistema.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	ntsecapi.h
Biblioteca	Secur32.lib
DLL	Secur32.dll