Compartir a través de

WESL_UserSetting.SetCustomShell

  • Artículo
  • Se aplica a:
    ✅ Windows 11, ✅ Windows 10

Este método configura shell Selector 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 configura shell Selector.

Shell
[in, required] La aplicación o ejecutable que shell Selector se inicia 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 shell Selector realiza 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 Reinicie el dispositivo.
2 Apague el dispositivo.
3 No haga nada.

DefaultAction
[In] Acción predeterminada que shell Selector 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 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 shell Selector 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, Shell Selector usa DefaultAction para determinar el comportamiento del sistema. Si DefaultAction no está definido o no es un valor válido, Shell Selector 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í