WESL_UserSetting.SetCustomShell
Este método configura shell Launcher para un usuario o grupo específico, en función del identificador de seguridad (SID).
Sintaxis
[Static] uint32 SetCustomShell (
[In, Required] string Sid,
[In, Required] string Shell,
[In] sint32 CustomReturnCodes[],
[In] sint32 CustomReturnCodesAction[],
[In] sint32 DefaultAction
);
Parámetros
Sid
[in, required] Cadena que contiene el identificador de seguridad (SID) del usuario o grupo para el que se está configurando shell Launcher.
Cáscara
[in, required] Aplicación o ejecutable que inicia shell Launcher como shell.
CustomReturnCodes
[in] Matriz de códigos de retorno personalizados que la aplicación de shell puede devolver.
CustomReturnCodesAction
[in] Matriz de acciones de código de retorno personalizadas que determinan la acción que realiza shell Launcher cuando se cierra la aplicación de shell. Las acciones personalizadas se asignan a la matriz de CustomReturnCodes.
Las acciones posibles se definen en la tabla siguiente:
| Value | Descripción |
|---|---|
| 0 | Reinicie el shell. |
| 1 | Reinicie el dispositivo. |
| 2 | Apague el dispositivo. |
| 3 | No haga nada. |
DefaultAction
[In] La acción predeterminada que realiza shell Launcher cuando se cierra la aplicación de shell.
Las acciones posibles se definen en la tabla siguiente:
| Value | Descripción |
|---|---|
| 0 | Reinicie el shell. |
| 1 | Reinicie el dispositivo. |
| 2 | Apague el dispositivo. |
| 3 | No haga nada. |
Valor devuelto
Devuelve un valor HRESULT que indica el estado de WMI o un error de WMI.
Comentarios
El iniciador de shell usa las matrices CustomReturnCodes y CustomReturnCodesAction para determinar el comportamiento del sistema cuando se cierra la aplicación de shell, en función del valor devuelto de la aplicación de shell.
Si el valor devuelto no existe en CustomReturnCodes o si la acción correspondiente definida en CustomReturnCodesAction no es un valor válido, el iniciador de Shell usa DefaultAction para determinar el comportamiento del sistema. Si DefaultAction no está definido o no es un valor válido, shell Launcher reinicia la aplicación de shell.
Requisitos
| Edición de Windows | Compatible |
|---|---|
| Windows Home | No |
| Windows Pro | No |
| Windows Enterprise | Sí |
| Windows Education | Sí |
| Windows IoT Enterprise | Sí |