WESL_UserSetting.GetCustomShell
Esse método recupera a configuração do Iniciador de Shell para um usuário ou grupo específico, com base no identificador de segurança (SID).
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 de caracteres que contém o identificador de segurança (SID) do usuário ou grupo para o qual o Iniciador de Shell está configurado.
Shell
[out, required] O aplicativo ou executável que o Iniciador de Shell inicia como o shell.
CustomReturnCodes
[out, required] Uma matriz de códigos de retorno personalizados retornados pelo aplicativo shell.
CustomReturnCodesAction
[out, required] 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 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
[out, required] 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.
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 |