WESL_UserSetting.SetCustomShell
Этот метод настраивает средство запуска оболочки для определенного пользователя или группы на основе идентификатора безопасности (SID).
Синтаксис
[Static] uint32 SetCustomShell (
[In, Required] string Sid,
[In, Required] string Shell,
[In] sint32 CustomReturnCodes[],
[In] sint32 CustomReturnCodesAction[],
[In] sint32 DefaultAction
);
Параметры
Sid
[in, обязательный] Строка, содержащая идентификатор безопасности (SID) пользователя или группы, для которой настраивается средство запуска оболочки.
Shell
[in, обязательный] Приложение или исполняемый файл, который запускается в качестве оболочки.
CustomReturnCodes
[in] Массив пользовательских кодов возврата, которые могут быть возвращены приложением оболочки.
CustomReturnCodesAction
[in] Массив пользовательских действий возвращаемого кода, определяющий действие, которое выполняет средство запуска оболочки при выходе приложения оболочки. Пользовательские действия сопоставляют массив CustomReturnCodes.
Возможные действия определяются в следующей таблице:
| значение | Описание |
|---|---|
| 0 | Перезапустите оболочку. |
| 1 | Перезапустите устройство. |
| 2 | Завершите работу устройства. |
| 3 | Никакие действия не выполняются. |
DefaultAction
[In] Действие по умолчанию, которое средство запуска оболочки принимает при выходе из приложения оболочки.
Возможные действия определяются в следующей таблице:
| значение | Описание |
|---|---|
| 0 | Перезапустите оболочку. |
| 1 | Перезапустите устройство. |
| 2 | Завершите работу устройства. |
| 3 | Никакие действия не выполняются. |
Возвращаемое значение
Возвращает значение HRESULT, указывающее состояние WMI или ошибку WMI.
Замечания
Средство запуска оболочки использует массивы CustomReturnCodes и CustomReturnCodesAction для определения поведения системы при выходе приложения оболочки на основе возвращаемого значения приложения оболочки.
Если возвращаемое значение не существует в CustomReturnCodes или если соответствующее действие, определенное в CustomReturnCodesAction, не является допустимым, средство запуска оболочки использует DefaultAction для определения системного поведения. Если DefaultAction не определен или не является допустимым значением, средство запуска оболочки перезапускает приложение оболочки.
Требования
| Выпуск для Windows | Поддерживается |
|---|---|
| Windows Домашняя | No |
| Windows Pro | No |
| Windows Корпоративная | Да |
| Windows для образовательных учреждений | Да |
| Windows IoT Корпоративная | Да |