WESL_UserSetting.GetCustomShell
Cette méthode récupère la configuration du 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 GetCustomShell (
[In, Required] string Sid,
[Out, Required] string Shell,
[Out, Required] sint32 CustomReturnCodes[],
[Out, Required] sint32 CustomReturnCodesAction[],
[Out, Required] sint32 DefaultAction
);
Paramètres
Sid
[in, obligatoire] Chaîne contenant l’identificateur de sécurité (SID) de l’utilisateur ou du groupe pour lequel shell Launcher est configuré.
Coquille
[out, obligatoire] Application ou exécutable que le lanceur d’interpréteur de commandes démarre en tant qu’interpréteur de commandes.
CustomReturnCodes
[out, obligatoire] Tableau de codes de retour personnalisés retournés par l’application shell.
CustomReturnCodesAction
[out, obligatoire] 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
[out, obligatoire] 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 à la sortie de l’application shell, en fonction de la valeur de retour de l’application.
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.
Conditions préalables
| Édition de Windows | Pris en charge |
|---|---|
| Windows Famille | Non |
| Windows Pro | Non |
| Windows Entreprise | Oui |
| Windows Éducation | Oui |
| Windows IoT Entreprise | Oui |