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
[вход, обязательный параметр] Строка, содержащая идентификатор безопасности (SID) пользователя или группы, для которых настраивается средство запуска оболочки.

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

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

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

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

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

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

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

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

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

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

Комментарии

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

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

Требования

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