Partilhar 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 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 verifique 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. Eles são descritos 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 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

Domínio Descrição dos dados da ação
[1] Nome da variável de ambiente a ser modificada.
[2] O valor da variável de ambiente.
[3] Este é um campo de sinalizadores de bits que especificam a ação a ser executada. Inclua apenas um bit para uma ação principal. Pode haver mais de um bit modificador incluído neste campo. Consulte as seguintes descrições de sinalizadores de bits.

 

Valor de bit Descrição das ações principais
0x1 Conjunto. Define o valor da variável de ambiente em todos os casos.
Se esse bit for combinado com um bit modificador Append ou Prefix, a ação adicionará o valor a qualquer valor existente na variável.
0x2 Conjunto. Define o valor se a variável estiver ausente.
Se esse bit for combinado com um bit modificador Append ou Prefix, 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 Append ou Prefix, o valor será removido da cadeia de caracteres existente, se o valor existir.

 

Valor de bit Descrição do modificador
0x20000000 Se esse bit for definido, as ações serão aplicadas às variáveis de ambiente da máquina.
Se esse bit não estiver definido, as ações serão aplicadas às variáveis de ambiente do usuário.
0x40000000 Anexar. Este bit é opcional. Não defina os modificadores Append e Prefix.
0x80000000 Prefixo. Este bit é opcional. Não defina os modificadores Append e Prefix.