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_CLIENT_CREDENTIALS

PWLX_QUERY_CLIENT_CREDENTIALS (winwlx.h)

Called by a replacement GINA DLL if Terminal Services is enabled. GINA calls this function to retrieve the credentials of remote Terminal Services clients that are not using an Internet connector license.

PWLX_QUERY_CLIENT_CREDENTIALS

PWLX_QUERY_CLIENT_CREDENTIALS callback

WlxQueryClientCredentials

WlxQueryClientCredentials callback function [Security]

_gina_wlxqueryclientcredentials

security.wlxqueryclientcredentials

winwlx/WlxQueryClientCredentials

security\wlxqueryclientcredentials.htm

security

b563606d-f4d5-48d7-914d-a11ed5f536a1

12/05/2018

PWLX_QUERY_CLIENT_CREDENTIALS, PWLX_QUERY_CLIENT_CREDENTIALS callback, WlxQueryClientCredentials, WlxQueryClientCredentials callback function [Security], _gina_wlxqueryclientcredentials, security.wlxqueryclientcredentials, winwlx/WlxQueryClientCredentials

winwlx.h

Windows

Windows XP [desktop apps only]

Windows Server 2003 [desktop apps only]

Windows

19H1

PWLX_QUERY_CLIENT_CREDENTIALS

winwlx/PWLX_QUERY_CLIENT_CREDENTIALS

c++

APIRef

kbSyntax

UserDefined

winwlx.h

WlxQueryClientCredentials

PWLX_QUERY_CLIENT_CREDENTIALS callback function

-description

[The WlxQueryClientCredentials function is no longer available for use as of Windows Server 2008 and Windows Vista.]

The WlxQueryClientCredentials function is called by a replacement GINA DLL if Terminal Services is enabled.

Note GINA DLLs are ignored in Windows Vista.

GINA calls this function to retrieve the credentials of remote Terminal Services clients that are not using an Internet connector license.

The GINA DLL can use this information to fill in a logon box automatically and attempt to log the user in.

-parameters

-param pCred [out]

Specifies a pointer to a WLX_CLIENT_CREDENTIALS_INFO_V1_0 structure that contains the credentials of the client on return.

-returns

The WlxQueryClientCredentials 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

The GINA DLL is responsible for calling LocalFree to free the resources used by this structure when the structure is no longer needed.

In order to access this function, the GINA DLL must use the WLX_DISPATCH_VERSION_1_3 structure, and set the Winlogon version to at least WLX_VERSION_1_3 in its WlxNegotiate call.

If the Terminal Services client is using an Internet connector license, the GINA DLL must call WlxQueryInetConnectorCredentials.

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