PWLX_QUERY_CLIENT_CREDENTIALS fonction de rappel (winwlx.h)

Article
03/04/2024

[La fonction WlxQueryClientCredentials n’est plus disponible depuis Windows Server 2008 et Windows Vista.]

La fonction WlxQueryClientCredentials est appelée par une DLL GINA de remplacement si Terminal Services est activé.

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

GINA appelle cette fonction pour récupérer les informations d’identification des clients des services Terminal Server distants qui n’utilisent pas de licence de connecteur Internet.

La DLL GINA peut utiliser ces informations pour remplir automatiquement une zone d’ouverture de session et tenter de connecter l’utilisateur.

Syntaxe

PWLX_QUERY_CLIENT_CREDENTIALS PwlxQueryClientCredentials;

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

Paramètres

[out] pCred

Spécifie un pointeur vers une structure WLX_CLIENT_CREDENTIALS_INFO_V1_0 qui contient les informations d’identification du client au retour.

Valeur retournée

La fonction WlxQueryClientCredentials 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

La DLL GINA est chargée d’appeler LocalFree pour libérer les ressources utilisées par cette structure lorsque la structure n’est plus nécessaire.

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

Si le client Terminal Services utilise une licence de connecteur Internet, la DLL GINA doit appeler WlxQueryInetConnectorCredentials.

D’autres fonctions Winlogon prennent en charge les fonctions qui peuvent être appelées lorsque Terminal Services est activé sont WlxDisconnect, WlxQueryInetConnectorCredentials 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