windows-itpro-docs/windows/configuration/shell-launcher/wesl-usersettinggetdefaultshell.md
Paolo Matarazzo 804d027c4d acrolinx
2025-01-15 09:54:30 -05:00

1.5 KiB

title, description, ms.date, ms.topic
title description ms.date ms.topic
WESL_UserSetting.GetDefaultShell WESL_UserSetting.GetDefaultShell 05/20/2024 reference

WESL_UserSetting.GetDefaultShell

This method retrieves the default Shell Launcher configuration.

Syntax

[Static] uint32 GetDefaultShell (
    [Out, Required] string Shell,
    [Out, Required] sint32 DefaultAction
);

Parameters

Shell
[out, required] The application or executable that Shell Launcher starts as the shell.

DefaultAction
[out, required] The default action Shell Launcher takes when the shell application exits.

The possible actions are defined in the following table:

Value Description
0 Restart the shell.
1 Restart the device.
2 Shut down the device.
3 Do nothing.

Return Value

Returns an HRESULT value that indicates WMI status or a WMI error.

Remarks

Shell Launcher uses the default configuration when the security identifier (SID) of the user who is currently signed in does not match any custom defined Shell Launcher configurations.

Requirements

Windows Edition Supported
Windows Home No
Windows Pro No
Windows Enterprise Yes
Windows Education Yes
Windows IoT Enterprise Yes