WlxStartApplication, fonction (winwlx.h)

Article
08/28/2023

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

La fonction WlxStartApplication peut être implémentée par une DLL GINA de remplacement. Winlogon appelle cette fonction lorsque le système a besoin qu’une application soit démarrée dans le contexte de l’utilisateur.

Il existe deux raisons pour lesquelles le système peut avoir besoin d’une application pour démarrer dans le contexte de l’utilisateur :

Windows Explorer s’est arrêté de manière inattendue et doit être redémarré.
Le gestionnaire de tâches étendu doit s’exécuter.

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

Le GINA peut remplacer ce comportement, le cas échéant, à l’aide de la fonction WlxStartApplication .

Syntaxe

BOOL WlxStartApplication(
  [in] PVOID pWlxContext,
  [in] PWSTR pszDesktopName,
  [in] PVOID pEnvironment,
  [in] PWSTR pszCmdLine
);

Paramètres

[in] pWlxContext

Pointeur vers le contexte GINA associé à cette station de fenêtre. Le GINA retourne cette valeur de contexte lorsque Winlogon appelle WlxInitialize pour cette station.

[in] pszDesktopName

Spécifie le nom du bureau sur lequel démarrer l’application. Transmettez cette chaîne à la fonction CreateProcess ou CreateProcessAsUser via le membre lpDesktop de la structure STARTUPINFO .

[in] pEnvironment

Spécifie l’environnement initial du processus. Winlogon crée cet environnement et le transmet au GINA. Le GINA peut modifier cet environnement avant de l’utiliser pour initialiser l’interpréteur de commandes de l’utilisateur. Lorsque le GINA a fini d’utiliser cet environnement, il doit libérer la mémoire allouée pour pEnvironment en appelant la fonction VirtualFree .

[in] pszCmdLine

Programme à exécuter.

Valeur retournée

Si la fonction démarre correctement l’application, la fonction retourne TRUE.

Si la fonction échoue ou si l’application n’a pas démarré, la fonction retourne FALSE.

Remarques

Avant d’appeler WlxStartApplication, 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é.

Si la fonction WlxStartApplication n’est pas exportée par le GINA, Winlogon exécute le processus.

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

WlxInitialize

Partager via