WESL_UserSetting.SetCustomShell
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).
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 ferme. 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 que le lanceur d’interpréteur de commandes effectue lorsque l’application shell se ferme.
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 l’état de 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 ferme, 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.
Configuration requise
| Édition Windows | Prise en charge |
|---|---|
| Windows Famille | Non |
| Windows Professionnel | Non |
| Windows Entreprise | Oui |
| Windows Éducation | Oui |
| Windows IoT Entreprise | Oui |