PWLX_QUERY_IC_CREDENTIALS fonction de rappel (winwlx.h)

Article
08/28/2023

[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