PWLX_QUERY_TS_LOGON_CREDENTIALS fonction de rappel (winwlx.h)

Article
03/04/2024

Appelée par une DLL GINA de remplacement pour récupérer les informations d’identification si les services Terminal Server sont activés. La DLL GINA peut ensuite utiliser ces informations pour remplir automatiquement une zone d’ouverture de session et tenter de connecter l’utilisateur.

Note Les DLL GINA sont ignorées dans Windows Vista.

Syntaxe

PWLX_QUERY_TS_LOGON_CREDENTIALS PwlxQueryTsLogonCredentials;

BOOL PwlxQueryTsLogonCredentials(
  [out] PWLX_CLIENT_CREDENTIALS_INFO_V2_0 pCred
)
{...}

Paramètres

[out] pCred

Lorsque la valeur de retour est TRUE, pCred spécifie un pointeur vers une structure WLX_CLIENT_CREDENTIALS_INFO_V2_0 qui contient les informations d’identification à utiliser pour l’ouverture de session automatique.

Valeur retournée

La fonction WlxQueryTsLogonCredentials retourne l’une des valeurs suivantes.

Code de retour	Description
TRUE	Les informations d’identification ont été récupérées et retournées dans pCred.
FALSE	Les informations d’identification n’ont pas été récupérées.

Remarques

Cette fonction remplace les fonctions WlxQueryClientCredentials et WlxQueryInetConnectorCredentials .

Pour accéder à cette fonction, la DLL GINA doit utiliser la structure WLX_DISPATCH_VERSION_1_4 et définir la version de Winlogon sur au moins WLX_VERSION_1_4 dans son appel WlxNegotiate .

D’autres fonctions Winlogon prennent en charge les fonctions qui peuvent être appelées lorsque les services Terminal Server sont activées : WlxDisconnect, WlxQueryClientCredentials, WlxQueryTerminalServicesData et WlxWin31Migrate.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winwlx.h