WlxInitialize, fonction (winwlx.h)

Article
03/04/2024

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

La fonction WlxInitialize doit être implémentée par une DLL GINA de remplacement. Winlogon appelle cette fonction une fois pour chaque station de fenêtre présente sur l’ordinateur. Actuellement, le système d’exploitation prend en charge une station de fenêtre par station de travail.

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

Le contexte retourné par cette fonction sera renvoyé au GINA dans tous les appels suivants.

Syntaxe

BOOL WlxInitialize(
  [in]  LPWSTR lpWinsta,
  [in]  HANDLE hWlx,
  [in]  PVOID  pvReserved,
  [in]  PVOID  pWinlogonFunctions,
  [out] PVOID  *pWlxContext
);

Paramètres

[in] lpWinsta

Pointeur vers le nom de la station de fenêtre en cours d’initialisation.

[in] hWlx

Handle pour Winlogon. Le GINA doit fournir ce handle dans tous les appels aux fonctions de prise en charge Winlogon qui impliquent cette station de fenêtre.

[in] pvReserved

Ce paramètre est réservé à une utilisation ultérieure et doit être défini sur NULL.

[in] pWinlogonFunctions

Pointeur vers une table de répartition de fonction de prise en charge Winlogon. Le contenu de la table dépend de la version de la DLL GINA retournée par l’appel WlxNegotiate . Cette table ne change pas, ce qui permet à la DLL GINA de référencer la table sans la copier. Si la DLL GINA doit effectuer une copie de la table, elle doit appeler WlxGetOption et fournir WLX_OPTION_DISPATCH_TABLE_SIZE pour le paramètre Option .

Valeur	Signification
WLX_DISPATCH_VERSION_1_4	Table de répartition Winlogon - version 1.4
WLX_DISPATCH_VERSION_1_3	Table de répartition Winlogon - version 1.3
WLX_DISPATCH_VERSION_1_2	Table de répartition Winlogon - version 1.2
WLX_DISPATCH_VERSION_1_1	Table Winlogondispatch - version 1.1
WLX_DISPATCH_VERSION_1_0	Table de répartition Winlogon - version 1.0

[out] pWlxContext

Pointeur vers un pointeur vers un VOID qui contiendra l’adresse du contexte GINA pour cette station de fenêtre. Ce contexte est passé dans tous les appels suivants au GINA à partir de Winlogon. La DLL GINA gère toute la mémoire utilisée par le contexte. Le pointeur de contexte peut être modifié ultérieurement en appelant la fonction WlxSetOption avec WLX_OPTION_CONTEXT_POINTER.

Valeur retournée

Si la fonction initialise correctement la DLL GINA, la fonction retourne TRUE.

Si la fonction échoue ou si la DLL GINA n’a pas été initialisée, la fonction retourne FALSE. Winlogon se termine et le système ne démarre pas.

Remarques

WlxInitialize est appelé une fois pour chaque station de fenêtre présente sur l’ordinateur.

Actuellement, une seule station de fenêtre appelée Winsta0 est prise en charge.

Avant d’appeler WlxInitialize, Winlogon définit l’état du bureau afin que le bureau actuel soit le bureau Winlogon et définit l’état de la station de travail afin que le bureau soit verrouillé.

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

Voir aussi

WlxNegotiate