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 |