windows-itpro-docs/windows/configuration/shell-launcher/wesl-usersettingsetenabled.md
Paolo Matarazzo 21a9b5ee91 timestamps
2025-03-07 12:03:40 -05:00

1.2 KiB

title, description, ms.date, ms.topic
title description ms.date ms.topic
WESL_UserSetting.SetEnabled WESL_UserSetting.SetEnabled 3/7/2025 reference

WESL_UserSetting.SetEnabled

This method enables or disables Shell Launcher.

[!INCLUDE shell-launcher]

Syntax

[Static] uint32 SetEnabled(
    [In, Required] boolean Enabled
);

Parameters

Enabled
[in, required] A Boolean value that indicates whether to enable or disable Shell Launcher.

Return Value

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

Remarks

This method enables or disables Shell Launcher by modifying the Shell value in the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Winlogon. If Unified Write Filter (UWF) is enabled, you may need to disable UWF or commit this registry key by using UWF_RegistryFilter.CommitRegistry in order to enable or disable Shell Launcher.

Enabling or disabling Shell Launcher does not take effect until a user signs in.