PWLX_QUERY_CLIENT_CREDENTIALS回调函数 (winwlx.h)
[自 Windows Server 2008 和 Windows Vista 起,WlxQueryClientCredentials 函数不再可用。]
如果启用了终端服务,则替换 GINA DLL 将调用 WlxQueryClientCredentials 函数。
注意 在 Windows Vista 中忽略 GINA DLL。
GINA DLL 可以使用此信息自动填充登录框,并尝试将用户登录。
语法
PWLX_QUERY_CLIENT_CREDENTIALS PwlxQueryClientCredentials;
BOOL PwlxQueryClientCredentials(
[out] PWLX_CLIENT_CREDENTIALS_INFO_V1_0 pCred
)
{...}
参数
[out] pCred
指定指向 WLX_CLIENT_CREDENTIALS_INFO_V1_0 结构的指针,该结构包含返回时客户端的凭据。
返回值
WlxQueryClientCredentials 函数返回以下值之一。
返回代码 | 说明 |
---|---|
|
凭据信息在 pCred 中检索并返回。 |
|
未检索凭据信息。 |
注解
当不再需要该结构时,GINA DLL 负责调用 LocalFree 以释放此结构使用的资源。
为了访问此函数,GINA DLL 必须使用 WLX_DISPATCH_VERSION_1_3 结构,并在其 WlxNegotiate 调用中将 Winlogon 版本设置为至少WLX_VERSION_1_3。
如果终端服务客户端使用 Internet 连接器许可证,则 GINA DLL 必须调用 WlxQueryInetConnectorCredentials。
其他 Winlogon 支持启用终端服务时可能调用的函数有 WlxDisconnect、 WlxQueryInetConnectorCredentials 和 WlxWin31Migrate。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | winwlx.h |