PWLX_QUERY_TERMINAL_SERVICES_DATA回调函数 (winwlx.h)
[自 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 |