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 支持启用终端服务时可能调用的函数有 WlxDisconnect、 WlxQueryInetConnectorCredentials 和 WlxWin31Migrate。