Compartilhar via

WESL_UserSetting.SetCustomShell

  • Artigo
  • Aplica-se a:
    ✅ Windows 11, ✅ Windows 10

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

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, required] Uma cadeia de caracteres que contém o identificador de segurança (SID) do usuário ou grupo para o qual o Iniciador de Shell está sendo configurado.

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

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

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

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

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

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

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

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

Valor Retornado

Retorna um valor HRESULT que indica o status WMI ou um erro 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 de retorno do aplicativo shell.

Se o valor de retorno 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 shell.

Requisitos

Edição do Windows Com suporte
Windows Home Não
Windows Pro Não
Windows Enterprise Sim
Educação do Windows Sim
Windows IoT Enterprise Yes