Partager via


PWLX_QUERY_IC_CREDENTIALS fonction de rappel (winwlx.h)

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

Appelée par une DLL GINA de remplacement si Terminal Services est activé. GINA appelle cette fonction pour déterminer si le serveur Terminal Server utilise la licence du connecteur Internet et pour récupérer les informations d’identification .

Note Les DLL GINA sont ignorées dans Windows Vista.
 
La DLL GINA peut ensuite utiliser ces informations pour remplir automatiquement une zone d’ouverture de session et tenter de connecter l’utilisateur.

Syntaxe

PWLX_QUERY_IC_CREDENTIALS PwlxQueryIcCredentials;

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

Paramètres

[out] pCred

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

Valeur retournée

La fonction WlxQueryInetConnectorCredentials retourne l’une des valeurs suivantes.

Code de retour Description
TRUE
Les licences de connecteur Internet sont activées.
FALSE
La licence du connecteur Internet n’est pas disponible.

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 Terminal Services n’utilise pas de licence de connecteur Internet, la DLL GINA doit appeler WlxQueryClientCredentials.

WlxDisconnect, WlxQueryClientCredentials, WlxQueryClientCredentials, WlxQueryTerminalServicesData et WlxWin31Migrate sont d’autres fonctions de prise en charge winlogon qui peuvent être appelées lorsque Terminal Services est activé.

Spécifications

   
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

Voir aussi

WLX_DISPATCH_VERSION_1_3

WlxDisconnect

WlxNegotiate

WlxQueryClientCredentials

WlxWin31Migrate