LsaGetLogonSessionData 函数 (ntsecapi.h)

LsaGetLogonSessionData 函数检索有关指定登录会话的信息。

若要检索有关登录会话的信息，调用方必须是会话的所有者或本地系统管理员。

语法

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

[in] LogonId

指定指向 LUID 的指针，该指针标识将检索其信息的登录会话。有关此参数的有效值的信息，请参阅备注。

[out] ppLogonSessionData

指向包含 LogonId 所指定的登录会话相关信息的SECURITY_LOGON_SESSION_DATA结构的指针的地址。此结构由 LSA 分配。不再需要信息时，调用 LsaFreeReturnBuffer 函数以释放此结构使用的内存。

如果函数成功，则返回值STATUS_SUCCESS。

如果函数失败，则返回值为指示原因的 NTSTATUS 代码。

若要获取可传递给此函数的 LogonId 参数的有效登录会话标识符，请调用 LsaEnumerateLogonSessions 函数。

如果 LogonID (0x0：0x3e7) 指定 LocalSystem 帐户，则此函数为 在 ppLogonSessionData 中检索的登录会话数据返回零。原因是 LocalSystem 帐户未以典型的登录方式登录。相反，LocalSystem 帐户在系统启动后处于活动状态。