Функция LsaGetLogonSessionData (ntsecapi.h)

Функция LsaGetLogonSessionData извлекает сведения об указанном сеансе входа.

Чтобы получить сведения о сеансе входа, вызывающий объект должен быть владельцем сеанса или локальным системным администратором.

Синтаксис

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

Параметры

[in] LogonId

Указывает указатель на LUID , идентифицирующий сеанс входа, данные которого будут извлечены. Сведения о допустимых значениях для этого параметра см. в разделе Примечания.

[out] ppLogonSessionData

Адрес указателя на структуру SECURITY_LOGON_SESSION_DATA , содержащую сведения о сеансе входа, заданном параметром LogonId. Эта структура выделяется LSA. Если информация больше не нужна, вызовите функцию LsaFreeReturnBuffer , чтобы освободить память, используемую этой структурой.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет STATUS_SUCCESS.

Если функция завершается сбоем, возвращаемым значением будет код NTSTATUS , указывающий причину.

Комментарии

Чтобы получить допустимые идентификаторы сеанса входа, которые могут быть переданы параметру LogonId этой функции, вызовите функцию LsaEnumerateLogonSessions .

Если LogonID указывает учетную запись LocalSystem (0x0:0x3e7), эта функция возвращает ноль для данных сеанса входа, полученных в ppLogonSessionData. Причина заключается в том, что учетная запись LocalSystem не входит в систему обычным способом входа. Скорее, учетная запись LocalSystem активна после запуска системы.

Требования