PWLX_QUERY_IC_CREDENTIALS回调函数 (winwlx.h)

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

如果启用了终端服务，则由替换 GINA DLL 调用。 GINA 调用此函数以确定终端服务器是否正在使用 Internet 连接器许可并检索凭据信息。

注意在 Windows Vista 中忽略 GINA DLL。

然后，GINA DLL 可以使用此信息自动填写登录框，并尝试将用户登录。

语法

PWLX_QUERY_IC_CREDENTIALS PwlxQueryIcCredentials;

BOOL PwlxQueryIcCredentials(
  [out] PWLX_CLIENT_CREDENTIALS_INFO_V1_0 pCred
)
{...}

[out] pCred

当返回值为 TRUE 时， pCred 指定指向包含用于自动登录的凭据的WLX_CLIENT_CREDENTIALS_INFO_V1_0 结构的指针。

WlxQueryInetConnectorCredentials 函数返回以下值之一。

返回代码	说明
TRUE	已启用 Internet 连接器许可。
FALSE	Internet 连接器许可不可用。

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

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

如果终端服务未使用 Internet 连接器许可证，GINA DLL 必须调用 WlxQueryClientCredentials。

其他 Winlogon 支持启用终端服务时可能调用的函数包括 WlxDisconnect、 WlxQueryClientCredentials、 WlxQueryTerminalServicesData 和 WlxWin31Migrate。