WESL_UserSetting.GetCustomShell

Cette méthode récupère la configuration Lanceur Shell 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, required] Chaîne contenant l’identificateur de sécurité (SID) de l’utilisateur ou du groupe pour lequel Shell Lanceur est configuré.

Shell [out, required] L’application ou l’exécutable que Shell Lanceur démarre comme interpréteur de commandes.

CustomReturnCodes [out, required] Tableau de codes de retour personnalisés retournés par l’application shell.

CustomReturnCodesAction [out, required] Tableau d’actions de code de retour personnalisées qui déterminent l’action prise par Shell Lanceur lors de la fermeture 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 [out, required] Action par défaut effectuée par Shell Lanceur lors de la fermeture 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 WMI ou une erreur WMI.

Remarques

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.

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.

Configuration requise

Édition Windows Prise en charge
Windows 10 Famille Non
Windows 10 Pro No
Windows 10 Entreprise Yes
Windows 10 Éducation Yes

WESL_UserSetting

Lanceur d’interpréteur de commandes