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