Share via

WESL_UserSetting.GetCustomShell

  • Artículo

Este método recupera la configuración de shell Selector para un usuario o grupo específico, en función del identificador de seguridad (SID).

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 Shell Selector.

Shell
[out, required] La aplicación o ejecutable que shell Selector se inicia 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 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
[out, required] La acción predeterminada que shell Selector toma 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.

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í