PWLX_QUERY_CLIENT_CREDENTIALS fonction de rappel (winwlx.h)
[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é.
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 |
|---|---|
|
Les informations d’identification ont été récupérées et retournées dans pCred. |
|
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 |