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 mudam para a instalação em andamento quando a ação WriteEnvironmentStrings ou a ação RemoveEnvironmentStrings são executadas. No Windows 2000, essas informações são armazenadas no registro e uma mensagem é enviada para notificar o sistema de alterações quando a instalação for 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 primárias e modificadores. Elas sã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 ambiente .

Restrições de sequência

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

Mensagens 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 especificam 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 de sinalizador de bit a seguir.

 

Valor do bit Descrição das ações primárias
0x1 Pôr. Define o valor da variável de ambiente em todos os casos.
Se esse bit for combinado com um bit de modificador de acréscimo ou prefixo, a ação adicionará o valor a qualquer valor existente na variável.
0x2 Pôr. Define o valor se a variável estiver ausente.
Se esse bit for combinado com um bit de modificador de acréscimo ou prefixo, a ação adicionará o valor a qualquer valor existente na variável.
0x4 Retirar. Remove o valor da variável.
Se esse bit for combinado com um bit modificador de acréscimo ou prefixo, o valor será removido da cadeia de caracteres existente, se o valor existir.

 

Valor do bit Descrição do modificador
0x20000000 Se esse bit for 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 append e prefixo.
0x80000000 Prefixo. Esse bit é opcional. Não defina os modificadores append e prefixo.