Compartir a través de


WESL_UserSetting.SetCustomShell

Este método configura el iniciador de shell para un usuario o grupo específico, en función del identificador de seguridad (SID).

Requisitos de la edición de Windows

En la tabla siguiente se enumeran las ediciones de Windows que admiten el iniciador de Shell:

Edición Compatibilidad con el iniciador de shell
Educación
Empresa
Enterprise LTSC
IoT Enterprise
IoT Enterprise LTSC
Pro Education
Pro
Inicio

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 el iniciador de shell.

Cáscara
[in, required] Aplicación o ejecutable que inicia el iniciador de shell como shell.

CustomReturnCodes
[in] Matriz de códigos de retorno personalizados que puede devolver la aplicación de shell.

CustomReturnCodesAction
[in] Matriz de acciones de código de retorno personalizadas que determinan la acción que realiza el iniciador de shell 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:

Valor Descripción
0 Reinicie el shell.
1 Reinicia el dispositivo.
2 Apague el dispositivo.
3 No hacer nada.

DefaultAction
[In] Acción predeterminada que el iniciador de shell realiza cuando se cierra la aplicación de shell.

Las acciones posibles se definen en la tabla siguiente:

Valor Descripción
0 Reinicie el shell.
1 Reinicia el dispositivo.
2 Apague el dispositivo.
3 No hacer nada.

Valor devuelto

Devuelve un valor HRESULT que indica el estado de WMI o un error wmi.

Observaciones

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, el iniciador de shell reinicia la aplicación de shell.