Поделиться через

WESL_UserSetting.SetCustomShell

  • Статья
  • Применяется к:
    ✅ Windows 11, ✅ Windows 10

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

Синтаксис

[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 не определен или не является допустимым значением, средство запуска оболочки перезапустит приложение оболочки.

Требования

Выпуск Windows Поддерживается
Домашняя страница Windows Нет
Windows Pro Нет
Windows Корпоративная Да
Windows для образовательных учреждений Да
Windows IoT Enterprise Да