WlxActivateUserShell, fonction (winwlx.h)

Article
08/28/2023

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

Active le programme de l’interpréteur de commandes utilisateur.

La fonction WlxActivateUserShell doit être implémentée par une DLL GINA de remplacement. Winlogon appelle cette fonction après une ouverture de session réussie pour demander à GINA d’activer le programme shell de l’utilisateur.

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

Syntaxe

BOOL WlxActivateUserShell(
  [in] PVOID pWlxContext,
  [in] PWSTR pszDesktopName,
  [in] PWSTR pszMprLogonScript,
  [in] PVOID pEnvironment
);

Paramètres

[in] pWlxContext

Pointeur vers le contexte GINA associé à cette station de fenêtre. Il s’agit de la valeur de contexte que le GINA retourne lorsque Winlogon appelle WlxInitialize pour cette station.

[in] pszDesktopName

Pointeur vers une chaîne de caractères larges terminée par null qui spécifie le nom du bureau où l’interpréteur de commandes démarre. Transmettez cette chaîne à la fonction CreateProcess ou CreateProcessAsUser via le membre lpDesktop de la structure STARTUPINFO .

[in] pszMprLogonScript

Pointeur vers une chaîne de caractères larges terminée par null qui spécifie les noms de script retournés par les DLL du fournisseur de réseau. Les DLL du fournisseur de réseau peuvent retourner des scripts à exécuter lors de l’ouverture de session ; toutefois, le GINA peut les ignorer.

[in] pEnvironment

Spécifie les variables d’environnement initiales pour le processus. Winlogon crée une copie de l’environnement et la remet au GINA. Le GINA peut modifier cet environnement avant de l’utiliser pour initialiser l’interpréteur de commandes de l’utilisateur. Le GINA doit appeler la fonction VirtualFree pour libérer la mémoire allouée à pEnvironment.

Valeur retournée

Si la fonction démarre correctement un processus d’interpréteur de commandes, la fonction retourne TRUE.

Si la fonction échoue, elle retourne FALSE. Lorsque false est retourné, Winlogon annule l’ouverture de session en cours.

Remarques

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

Activez toujours le programme d’interpréteur de commandes utilisateur dans WlxActivateUserShell plutôt que WlxLoggedOutSAS. Cela permet à Winlogon de mettre à jour son état, notamment de définir des protections de station de travail et de bureau, avant que les processus utilisateur connectés ne soient autorisés à s’exécuter.

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

Voir aussi

WlxInitialize

WlxLoggedOutSAS

WlxLogoff

Partager via