Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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).
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 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é.
Shell
[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.