Compartilhar via

Ação RemoveEnvironmentStrings

  • Artigo

A ação RemoveEnvironmentStrings modifica os valores das variáveis de ambiente.

Observe que as variáveis de ambiente não são alteradas para a instalação em andamento quando a ação WriteEnvironmentStrings ou a ação RemoveEnvironmentStrings é executada. No Windows 2000, essas informações são armazenadas no Registro, e uma mensagem é enviada para notificar o sistema das alterações quando a instalação é concluída. Um novo processo ou outro processo que verifica essas mensagens usará as novas variáveis de ambiente.

O instalador executa a ação WriteEnvironmentStrings somente durante a instalação ou reinstalação de um componente e executa a ação RemoveEnvironmentStrings somente durante a remoção de um componente.

Os valores são gravados ou removidos com base na seleção de ações e modificadores primários. Elas estão descritas na seção ActionData Messages a seguir. Observe que, dependendo da ação especificada, WriteEnvironmentStrings pode remover variáveis e RemoveEnvironmentStrings pode adicioná-las com base na criação da tabela Environment.

Restrições de sequência

A ação InstallValidate deve ser executada antes da ação RemoveEnvironmentStrings. Como a ação WriteEnvironmentStrings e RemoveEnvironmentStrings nunca são aplicadas durante a desinstalação ou remoção de um componente, sua sequência relativa não é restrita.

Mensagens de ActionData

Campo Descrição dos dados de ação
 [1] Nome da variável de ambiente a ser modificada.
[2] O valor da variável de ambiente.
[3] Esse é um campo de sinalizadores de bits que especifica a ação a ser executada. Inclua apenas um bit para uma ação primária. Pode haver mais de um bit modificador incluído neste campo. Confira as descrições do sinalizador de bit a seguir.

 

Valor de bit Descrição das ações primárias
0x1 Definido. Define o valor da variável de ambiente em todos os casos.
Se esse bit for combinado com um bit modificador Acrescentar ou Prefixo, a ação adicionará o valor a qualquer valor existente na variável.
0x2 Definido. Define o valor se a variável estiver ausente.
Se esse bit for combinado com um bit modificador Acrescentar ou Prefixo, a ação adicionará o valor a qualquer valor existente na variável.
0x4 Remover. Remove o valor da variável.
Se esse bit for combinado com um bit modificador Acrescentar ou Prefixo, o valor será removido da cadeia de caracteres existente, se o valor existir.

 

Valor de bit Descrição do modificador
0x20000000 Se esse bit estiver definido, as ações serão aplicadas às variáveis de ambiente do computador.
Se esse bit não estiver definido, as ações serão aplicadas às variáveis de ambiente do usuário.
0x40000000 Acrescentar. Esse bit é opcional. Não defina os modificadores Acrescentar e Prefixo.
0x80000000 Prefixo. Esse bit é opcional. Não defina os modificadores Acrescentar e Prefixo.