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.