Partilhar via

Ação WriteEnvironmentStrings

  • Artigo

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

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 são executadas. No Windows 2000, Windows Server 2003, Windows XP e Windows Vista, essas informações são armazenadas no registro e uma mensagem de WM_SETTINGCHANGE é enviada para notificar o sistema das alterações quando a instalação for concluída. Outro processo pode receber notificações das alterações manipulando essas mensagens. Nenhuma mensagem é enviada se uma reinicialização do sistema estiver pendente. Um pacote pode usar a propriedade MsiSystemRebootPending para verificar se uma reinicialização do sistema está pendente.

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 uma instalação ou remoção de um componente, sua sequência relativa não é restrita.

Mensagens ActionData

Campo 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 especifica 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 Remova. 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 do 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 configure os modificadores Append nem Prefix.
0x80000000 Prefixo. Este bit é opcional. Não configure ambos os modificadores Append e Prefix.