WESL_UserSetting.SetCustomShell

Этот метод настраивает средство запуска оболочки для определенного пользователя или группы на основе идентификатора безопасности (SID).

Требования к выпуску Windows

В следующем списке содержатся выпуски Windows, поддерживающие средство запуска оболочки:

✅ Enterprise / Enterprise LTSC
✅ для образования
✅ IIoT Enterprise или IoT Enterprise LTSC

Синтаксис

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

Параметры

Ид безопасности
[в, обязательно] Строка, содержащая идентификатор безопасности (SID) пользователя или группы, для которых настраивается средство запуска оболочки.

Оболочка
[в, обязательно] Приложение или исполняемый файл, запускаемый средство запуска оболочки как оболочка.

CustomReturnCodes
[в] Массив пользовательских кодов возврата, которые могут быть возвращены приложением оболочки.

CustomReturnCodesAction
[в] Массив настраиваемых действий кода возврата, определяющих действие, выполняемое средство запуска оболочки при выходе из приложения оболочки. Пользовательские действия сопоставляется с массивом CustomReturnCodes.

Возможные действия определены в следующей таблице:

Значение	Описание
0	Перезапустите оболочку.
1	Перезагрузите устройство.
2	Завершите работу устройства.
3	Не выполнять никаких действий.

DefaultAction
[In] Действие по умолчанию, выполняемое средство запуска оболочки при завершении работы приложения оболочки.

Возможные действия определены в следующей таблице:

Значение	Описание
0	Перезапустите оболочку.
1	Перезагрузите устройство.
2	Завершите работу устройства.
3	Не выполнять никаких действий.

Возвращенное значение

Возвращает значение HRESULT, указывающее состояние WMI или ошибку WMI.

Комментарии

Средство запуска оболочки использует массивы CustomReturnCodes и CustomReturnCodesAction для определения поведения системы при выходе приложения оболочки на основе возвращаемого значения приложения оболочки.

Если возвращаемое значение не существует в CustomReturnCodes или если соответствующее действие, определенное в CustomReturnCodesAction , не является допустимым значением, средство запуска оболочки использует DefaultAction для определения поведения системы. Если DefaultAction не определен или не является допустимым значением, средство запуска оболочки перезапустит приложение оболочки.