WESL_UserSetting.GetCustomShell

Este método recupera la configuración del 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

La lista siguiente contiene las ediciones de Windows que admiten Shell Launcher:

✅ Enterprise/Enterprise LTSC
✅ Educación
✅ IoT Enterprise/IoT Enterprise LTSC

Sintaxis

[Static] uint32 GetCustomShell (
    [In, Required] string Sid,
    [Out, Required] string Shell,
    [Out, Required] sint32 CustomReturnCodes[],
    [Out, Required] sint32 CustomReturnCodesAction[],
    [Out, Required] sint32 DefaultAction
);

Parámetros

Sid
[in, required] Cadena que contiene el identificador de seguridad (SID) del usuario o grupo para el que está configurado el iniciador de shell.

Shell
[out, required] Aplicación o ejecutable que inicia el iniciador de shell como shell.

CustomReturnCodes
[out, required] Matriz de códigos de retorno personalizados devueltos por la aplicación de shell.

CustomReturnCodesAction
[out, required] 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:

DefaultAction
[out, required] 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 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.

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.