WESL_UserSetting.SetCustomShell

Article
03/11/2025
S’applique à:

✅ Windows 11, ✅ Windows 10

Cette méthode configure le lanceur d’interpréteur de commandes pour un utilisateur ou un groupe spécifique, en fonction de l’identificateur de sécurité (SID).

Configuration requise pour l’édition De Windows

La liste suivante contient les éditions de Windows qui prennent en charge le lanceur d’interpréteur de commandes :

✅ Enterprise / Enterprise LTSC
✅ Éducation
✅ IoT Enterprise / IoT Enterprise LTSC

Syntaxe

[Static] uint32 SetCustomShell (
    [In, Required] string Sid,
    [In, Required] string Shell,
    [In] sint32 CustomReturnCodes[],
    [In] sint32 CustomReturnCodesAction[],
    [In] sint32 DefaultAction
);

Paramètres

Sid
[in, obligatoire] Chaîne contenant l’identificateur de sécurité (SID) de l’utilisateur ou du groupe pour lequel le lanceur d’interpréteur de commandes est configuré.

Shell
[in, obligatoire] Application ou exécutable que le lanceur d’interpréteur de commandes démarre en tant qu’interpréteur de commandes.

CustomReturnCodes
[in] Tableau de codes de retour personnalisés qui peuvent être retournés par l’application shell.

CustomReturnCodesAction
[in] Tableau d’actions de code de retour personnalisées qui déterminent l’action effectuée par le lanceur d’interpréteur de commandes lorsque l’application shell se termine. Les actions personnalisées sont mappées au tableau de CustomReturnCodes.

Les actions possibles sont définies dans le tableau suivant :

Valeur	Description
0	Redémarrez l’interpréteur de commandes.
1	Redémarrez l’appareil.
2	Arrêtez l’appareil.
3	Ne rien faire.

DefaultAction
[In] Action par défaut effectuée par le lanceur d’interpréteur de commandes lorsque l’application shell se termine.

Les actions possibles sont définies dans le tableau suivant :

Valeur	Description
0	Redémarrez l’interpréteur de commandes.
1	Redémarrez l’appareil.
2	Arrêtez l’appareil.
3	Ne rien faire.

Valeur renvoyée

Retourne une valeur HRESULT qui indique une status WMI ou une erreur WMI.

Remarques

Le lanceur d’interpréteur de commandes utilise les tableaux CustomReturnCodes et CustomReturnCodesAction pour déterminer le comportement du système lorsque l’application shell se termine, en fonction de la valeur de retour de l’application shell.

Si la valeur de retour n’existe pas dans CustomReturnCodes, ou si l’action correspondante définie dans CustomReturnCodesAction n’est pas une valeur valide, le lanceur d’interpréteur de commandes utilise DefaultAction pour déterminer le comportement du système. Si DefaultAction n’est pas défini ou n’est pas une valeur valide, le lanceur d’interpréteur de commandes redémarre l’application shell.

Partager via