Partager via


WlxInitialize, fonction (winwlx.h)

[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