Partager via

WESL_UserSetting.SetCustomShell

  • Article
  • S’applique à:
    ✅ Windows 11, ✅ Windows 10

Cette méthode configure shell Lanceur 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 Shell Lanceur est configuré.

Shell
[in, obligatoire] L’application ou l’exécutable que Shell Lanceur démarre en tant que shell.

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 Shell Lanceur lors de la sortie de l’application shell. 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 l’interpréteur de commandes Lanceur lors de la sortie de l’application shell.

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.

Notes

Shell Lanceur 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, Shell Lanceur utilise DefaultAction pour déterminer le comportement du système. Si DefaultAction n’est pas défini ou n’est pas une valeur valide, Shell Lanceur redémarre l’application shell.

Spécifications

Édition Windows Pris en charge
Windows Édition familiale Non
Windows Pro Non
Windows Entreprise Oui
Windows Éducation Oui
Windows IoT Entreprise Oui