WESL_UserSetting.GetCustomShell

  • Статья

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

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

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

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

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

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

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

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

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

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

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

Комментарии

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

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

Требования

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