WESL_UserSetting.GetCustomShell

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

语法

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

parameters

Sid [in, 必需] 一个字符串,其中包含配置 Shell Launcher的用户或组的安全标识符 (SID) 。

Shell [out, 必需] Shell Launcher作为 shell 启动的应用程序或可执行文件。

CustomReturnCodes [out, 必需] shell 应用程序返回的自定义返回代码数组。

CustomReturnCodesAction [out, 必需] 自定义返回代码操作的数组,用于确定 Shell 应用程序退出时 Shell Launcher执行的操作。 自定义操作映射到 CustomReturnCodes 数组。

下表定义了可能的操作:

说明

0

重启 shell。

1

重启设备。

2

关闭设备。

3

不执行任何操作。

DefaultAction [out, 必需] Shell Launcher退出 shell 应用程序时采用的默认操作。

下表定义了可能的操作:

说明

0

重启 shell。

1

重启设备。

2

关闭设备。

3

不执行任何操作。

返回值

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

注解

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

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

要求

Windows 版本 支持
Windows 10 家庭版
Windows 10 专业版
Windows 10 企业版
Windows 10 教育版

WESL_UserSetting

Shell 启动程序