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).
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 Launcher.
Cáscara
[out, required] Aplicación o ejecutable que el iniciador de Shell 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 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
[out, required] La 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:
| 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.
Si el valor devuelto no existe en CustomReturnCodes o si la acción correspondiente definida en CustomReturnCodesAction no es un valor válido, shell Launcher 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í |