PWLX_QUERY_CLIENT_CREDENTIALS回调函数 (winwlx.h)

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

如果启用了终端服务,则替换 GINA DLL 将调用 WlxQueryClientCredentials 函数。

注意 在 Windows Vista 中忽略 GINA DLL。
 
GINA 调用此函数以检索未使用 Internet 连接器许可证的远程终端服务客户端的 凭据

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 函数返回以下值之一。

返回代码 说明
TRUE
凭据信息在 pCred 中检索并返回。
FALSE
未检索凭据信息。

注解

当不再需要该结构时,GINA DLL 负责调用 LocalFree 以释放此结构使用的资源。

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

如果终端服务客户端使用 Internet 连接器许可证,则 GINA DLL 必须调用 WlxQueryInetConnectorCredentials

其他 Winlogon 支持启用终端服务时可能调用的函数有 WlxDisconnectWlxQueryInetConnectorCredentialsWlxWin31Migrate

要求

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

另请参阅

WLX_DISPATCH_VERSION_1_3

WlxDisconnect

WlxNegotiate

WlxQueryInetConnectorCredentials

WlxWin31Migrate