WESL_UserSetting.GetCustomShell

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

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

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

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

Синтаксис

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

Параметры

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

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

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

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

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

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

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

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

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

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

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

Комментарии

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

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