WESL_UserSetting.GetCustomShell

Este método obtém a configuração do Shell Launcher para um utilizador ou grupo específico, com base no identificador de segurança (SID).

Requisitos de edição do Windows

A lista seguinte contém as edições do Windows que suportam o Shell Launcher:

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

Sintaxe

[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] Uma cadeia que contém o identificador de segurança (SID) do utilizador ou grupo para o qual o Shell Launcher está configurado.

Shell
[fora, necessário] A aplicação ou executável que o Shell Launcher inicia como shell.

CustomReturnCodes
[fora, necessário] Uma matriz de códigos de retorno personalizados devolvidos pela aplicação shell.

CustomReturnCodesAction
[fora, necessário] Uma matriz de ações de código de retorno personalizadas que determinam a ação que o Shell Launcher executa quando a aplicação shell sai. As ações personalizadas mapeiam para a matriz de CustomReturnCodes.

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

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

DefaultAction
[fora, necessário] A ação predefinida que o Shell Launcher executa quando a aplicação shell sai.

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

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

Valor de retorno

Devolve um valor HRESULT que indica status WMI ou um erro WMI.

Comentários

O Shell Launcher utiliza as matrizes CustomReturnCodes e CustomReturnCodesAction para determinar o comportamento do sistema quando a aplicação shell sai, com base no valor devolvido da aplicação.

Se o valor devolvido 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 utiliza DefaultAction para determinar o comportamento do sistema. Se DefaultAction não estiver definido ou não for um valor válido, o Shell Launcher reinicia a aplicação shell.