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).

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:

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 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

Tópicos relacionados

• WESL_UserSetting
• Iniciador de Shell