PWLX_QUERY_TERMINAL_SERVICES_DATA fonction de rappel (winwlx.h)

Article
03/06/2024

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

Appelé par GINA pour récupérer les informations de configuration utilisateur des services Terminal Server une fois qu’un utilisateur s’est connecté.

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

Syntaxe

PWLX_QUERY_TERMINAL_SERVICES_DATA PwlxQueryTerminalServicesData;

DWORD PwlxQueryTerminalServicesData(
  [in]  HANDLE hWlx,
  [out] PWLX_TERMINAL_SERVICES_DATA pTSData,
  [in]  WCHAR *UserName,
  [in]  WCHAR *Domain
)
{...}

Paramètres

[in] hWlx

Spécifie le handle Winlogon passé à GINA dans l’appel WlxInitialize .

[out] pTSData

Pointe vers une structure qui contiendra les informations de configuration utilisateur spécifiques aux services Terminal Server.

[in] UserName

Pointeur vers une chaîne de caractères larges terminée par null qui spécifie le nom de l’utilisateur nouvellement connecté.

[in] Domain

Pointeur vers une chaîne de caractères larges terminée par null qui spécifie le domaine de l’utilisateur nouvellement connecté.

Valeur retournée

La fonction WlxQueryTerminalServicesData retourne zéro si les informations de configuration utilisateur ont été récupérées avec succès. Sinon, il retourne un code d’erreur.

Remarques

WlxQueryTerminalServicesData doit être appelé à partir de l’implémentation de WlxLoggedOutSAS par GINA une fois qu’un utilisateur a été authentifié.

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 .

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