PWLX_QUERY_TERMINAL_SERVICES_DATA回调函数 (winwlx.h)

项目
03/04/2024

[自 Windows Server 2008 和 Windows Vista 起，WlxQueryTerminalServicesData 函数不再可用。]

由 GINA 调用，以在用户登录后检索终端服务用户配置信息。

注意在 Windows Vista 中忽略 GINA DLL。

语法

PWLX_QUERY_TERMINAL_SERVICES_DATA PwlxQueryTerminalServicesData;

DWORD PwlxQueryTerminalServicesData(
  [in]  HANDLE hWlx,
  [out] PWLX_TERMINAL_SERVICES_DATA pTSData,
  [in]  WCHAR *UserName,
  [in]  WCHAR *Domain
)
{...}

参数

[in] hWlx

指定在 WlxInitialize 调用中传递给 GINA 的 Winlogon 句柄。

[out] pTSData

指向将包含特定于终端服务的用户配置信息的结构。

[in] UserName

指向以 null 结尾的宽字符串的指针，该字符串指定新登录用户的名称。

[in] Domain

指向以 null 结尾的宽字符串的指针，该字符串指定新登录用户的域。

返回值

如果成功检索用户配置信息， 则 WlxQueryTerminalServicesData 函数返回零。否则，它将返回错误代码。

注解

对用户进行身份验证后，应从 GINA 的 WlxLoggedOutSAS 实现中调用 WlxQueryTerminalServicesData。

为了访问此函数，GINA DLL 必须使用 WLX_DISPATCH_VERSION_1_3 结构，并在其 WlxNegotiate 调用中将 Winlogon 版本设置为至少WLX_VERSION_1_3。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	winwlx.h