WESL_UserSetting.SetCustomShell

Esse método configura o Iniciador de Shell para um usuário ou grupo específico, com base no identificador de segurança (SID).

Requisitos de edição do Windows

A lista a seguir contém as edições do Windows que oferecem suporte ao Iniciador de Shell:

✅ Enterprise / Enterprise LTSC
Educação ✅
Empresa de Internet das Coisas / LTSC Empresa Internet das Coisas ✅

Sintaxe

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

Parâmetros

Sid
[in, obrigatório] Uma cadeia de caracteres que contém o SID (identificador de segurança) do usuário ou grupo para o qual o Iniciador de Shell está sendo configurado.

Shell
[in, obrigatório] O aplicativo ou executável que o Iniciador de Shell inicia como o shell.

CustomReturnCodes
[em] Uma matriz de códigos de retorno personalizados que podem ser retornados pelo aplicativo de shell.

CustomReturnCodesAction
[em] Uma matriz de ações de código de retorno personalizadas que determinam a ação que o Iniciador de Shell executa quando o aplicativo de shell é encerrado. As ações personalizadas são mapeadas para a matriz de CustomReturnCodes.

As ações possíveis estão definidas na tabela a seguir:

Valor Descrição
0 Reinicie o shell.
1 Reinicie o dispositivo.
2 Desligue o dispositivo.
3 Não fazer nada.

DefaultAction
[Em] A ação padrão que o Iniciador de Shell executa quando o aplicativo de shell é encerrado.

As ações possíveis estão definidas na tabela a seguir:

Valor Descrição
0 Reinicie o shell.
1 Reinicie o dispositivo.
2 Desligue o dispositivo.
3 Não fazer nada.

Valor de retorno

Retorna um valor HRESULT que indica o status do WMI ou um erro de WMI.

Comentários

O Iniciador de Shell usa as matrizes CustomReturnCodes e CustomReturnCodesAction para determinar o comportamento do sistema quando o aplicativo shell é encerrado, com base no valor retornado do aplicativo shell.

Se o valor retornado não existir em CustomReturnCodes, ou se a ação correspondente definida em CustomReturnCodesAction não for um valor válido, o Iniciador de Shell usará DefaultAction para determinar o comportamento do sistema. Se DefaultAction não estiver definido ou não for um valor válido, o Iniciador de Shell reiniciará o aplicativo de shell.

  • Last updated on