Skip to content

Latest commit

 

History

History
127 lines (97 loc) · 4.41 KB

nc-winwlx-pwlx_query_ts_logon_credentials.md

File metadata and controls

127 lines (97 loc) · 4.41 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NC:winwlx.PWLX_QUERY_TS_LOGON_CREDENTIALS
PWLX_QUERY_TS_LOGON_CREDENTIALS (winwlx.h)
Called by a replacement GINA DLL to retrieve credentials information if Terminal Services is enabled. The GINA DLL can then use this information to fill in a logon box automatically and attempt to log the user in.
PWLX_QUERY_TS_LOGON_CREDENTIALS
PWLX_QUERY_TS_LOGON_CREDENTIALS callback
WlxQueryTsLogonCredentials
WlxQueryTsLogonCredentials callback function [Security]
security.wlxquerytslogoncredentials
winwlx/WlxQueryTsLogonCredentials
security\wlxquerytslogoncredentials.htm
security
1365b798-682e-4cdb-b8f5-9e7c65366154
12/05/2018
PWLX_QUERY_TS_LOGON_CREDENTIALS, PWLX_QUERY_TS_LOGON_CREDENTIALS callback, WlxQueryTsLogonCredentials, WlxQueryTsLogonCredentials callback function [Security], security.wlxquerytslogoncredentials, winwlx/WlxQueryTsLogonCredentials
winwlx.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
19H1
PWLX_QUERY_TS_LOGON_CREDENTIALS
winwlx/PWLX_QUERY_TS_LOGON_CREDENTIALS
c++
APIRef
kbSyntax
UserDefined
winwlx.h
WlxQueryTsLogonCredentials

PWLX_QUERY_TS_LOGON_CREDENTIALS callback function

-description

Called by a replacement GINA DLL to retrieve credentials information if Terminal Services is enabled. The GINA DLL can then use this information to fill in a logon box automatically and attempt to log the user in.

Note   GINA DLLs are ignored in Windows Vista.
 

-parameters

-param pCred [out]

When the return value is TRUE, pCred specifies a pointer to a WLX_CLIENT_CREDENTIALS_INFO_V2_0 structure that contains the credentials to use for auto logon.

-returns

The WlxQueryTsLogonCredentials function returns one of the following values.

Return code Description
TRUE
The credentials information was retrieved and returned in pCred.
FALSE
The credentials information was not retrieved.

-remarks

This function supersedes the WlxQueryClientCredentials and WlxQueryInetConnectorCredentials functions.

To access this function, the GINA DLL must use the WLX_DISPATCH_VERSION_1_4 structure and set the Winlogon version to at least WLX_VERSION_1_4 in its WlxNegotiate call.

Other Winlogon support functions that may be called when Terminal Services is enabled are WlxDisconnect, WlxQueryClientCredentials, WlxQueryTerminalServicesData, and WlxWin31Migrate.

-see-also

WLX_CLIENT_CREDENTIALS_INFO_V2_0

WlxDisconnect

WlxQueryClientCredentials

WlxQueryTerminalServicesData

WlxWin31Migrate