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

WESL_UserSetting.GetCustomShell

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

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

Синтаксис

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

Требования

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