LsaGetLogonSessionData 函数 (ntsecapi.h)
LsaGetLogonSessionData 函数检索有关指定登录会话的信息。
若要检索有关登录会话的信息,调用方必须是会话的所有者或本地系统管理员。
语法
NTSTATUS LsaGetLogonSessionData(
[in] PLUID LogonId,
[out] PSECURITY_LOGON_SESSION_DATA *ppLogonSessionData
);
parameters
[in] LogonId
指定指向 LUID 的指针,该指针标识将检索其信息的登录会话。 有关此参数的有效值的信息,请参阅备注。
[out] ppLogonSessionData
指向包含 LogonId 所指定的登录会话相关信息的SECURITY_LOGON_SESSION_DATA结构的指针的地址。 此结构由 LSA 分配。 不再需要信息时,调用 LsaFreeReturnBuffer 函数以释放此结构使用的内存。
返回值
如果函数成功,则返回值STATUS_SUCCESS。
如果函数失败,则返回值为指示原因的 NTSTATUS 代码。
注解
若要获取可传递给此函数的 LogonId 参数的有效登录会话标识符,请调用 LsaEnumerateLogonSessions 函数。
如果 LogonID (0x0:0x3e7) 指定 LocalSystem 帐户,则此函数为 在 ppLogonSessionData 中检索的登录会话数据返回零。 原因是 LocalSystem 帐户未以典型的登录方式登录。 相反,LocalSystem 帐户在系统启动后处于活动状态。
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | ntsecapi.h |
Library | Secur32.lib |
DLL | Secur32.dll |