通过

WESL_UserSetting.SetCustomShell

  • 项目
  • 适用于:
    ✅ Windows 11, ✅ Windows 10

此方法根据安全标识符 (SID) 配置特定用户或组的 Shell 启动程序。

语法

[Static] uint32 SetCustomShell (
    [In, Required] string Sid,
    [In, Required] string Shell,
    [In] sint32 CustomReturnCodes[],
    [In] sint32 CustomReturnCodesAction[],
    [In] sint32 DefaultAction
);

参数

Sid
[in, required] 一个字符串，其中包含为其配置 Shell 启动程序的用户或组的安全标识符 (SID)。

Shell [in, required] Shell 启动程序作为 shell 启动的应用程序或可执行文件
。

CustomReturnCodes
[in] Shell 应用程序可能返回的自定义返回码数组。

CustomReturnCodesAction
[in] 一组自定义返回代码操作，用于确定 Shell 启动程序在 shell 应用程序退出后执行的操作。 自定义操作映射到 CustomReturnCodes 数组。

下表定义了可能的操作：

值 说明
0 重启 shell。
1 重启设备。
2 关闭设备。
3 不执行任何操作。

DefaultAction
[In] Shell 启动器在 shell 应用程序退出时采用的默认操作。

下表定义了可能的操作：

值 说明
0 重启 shell。
1 重启设备。
2 关闭设备。
3 不执行任何操作。

返回值

返回指示 WMI 状态或 WMI 错误的 HRESULT 值。

注解

Shell 启动程序使用 CustomReturnCodes 和 CustomReturnCodesAction 数组来根据 shell 应用程序的返回值确定 shell 应用程序退出时的系统行为。

如果返回值在 CustomReturnCodes 中不存在，或者如果在 CustomReturnCodesAction 中定义的相应操作不是有效值，Shell 启动程序将使用 DefaultAction 来确定系统行为。 如果 DefaultAction 未定义或不是有效值，Shell 启动程序将重新启动 shell 应用程序。

要求

Windows 版本 支持
Windows 家庭版 否
Windows 专业版 否
Windows 企业版 是
Windows 教育版 是
Windows IoT 企业版 是