Acción WriteEnvironmentStrings

La acción WriteEnvironmentStrings modifica los valores de las variables de entorno.

Las variables de entorno no cambian para la instalación en curso cuando se ejecuta la acción WriteEnvironmentStrings o RemoveEnvironmentStrings. En Windows 2000, Windows Server 2003, Windows XP y Windows Vista, esta información se almacena en el registro y se envía un mensaje de WM_SETTINGCHANGE para notificar al sistema los cambios cuando se completa la instalación. Otro proceso puede recibir notificaciones de los cambios mediante el control estos mensajes. No se enviará ningún mensaje si hay pendiente un reinicio del sistema. Un paquete puede usar la propiedad MsiSystemRebootPending para comprobar si hay algún reinicio del sistema pendiente.

El instalador ejecuta la acción WriteEnvironmentStrings solo durante la instalación o reinstalación de un componente y ejecuta la acción RemoveEnvironmentStrings solo durante la eliminación de un componente.

Los valores se escriben o eliminan en función de la selección de acciones y modificadores principales. Estos se describen en la siguiente sección Mensajes ActionData. Tenga en cuenta que, en función de la acción especificada, WriteEnvironmentStrings puede quitar variables y RemoveEnvironmentStrings puede agregarlas en función de la creación de la tabla Environment.

Restricciones de secuencia

La acción InstallValidate debe ejecutarse antes de la acción RemoveEnvironmentStrings. Dado que la acción WriteEnvironmentStrings y la acción RemoveEnvironmentStrings nunca se aplican durante la instalación o eliminación de un componente, su secuencia relativa no está restringida.

Mensajes de ActionData

Campo	Descripción de los datos de acción
[1]	Nombre de la variable de entorno que se va a modificar.
[2]	Valor de la variable de entorno.
[3]	Se trata de un campo de marcas de bits que especifica la acción que se va a realizar. Incluya solo un bit para una acción principal. Puede haber más de un bit modificador incluido en este campo. Consulte las siguientes descripciones de marcas de bits.

 

Valor de bit	Descripción de las acciones principales
0x1	Establecer. Establece el valor de la variable de entorno en todos los casos. Si este bit se combina con un bit modificador Append o Prefix, la acción agrega el valor a cualquier valor existente de la variable.
0x2	Establecer. Establece el valor si la variable no está presente. Si este bit se combina con un bit modificador Append o Prefix, la acción agrega el valor a cualquier valor existente de la variable.
0x4	Eliminar. Quita el valor de la variable. Si este bit se combina con un bit modificador Append o Prefix, el valor se quita de la cadena existente, si el valor existe.

 

Valor de bit	Descripción del modificador
0x20000000	Si se establece este bit, las acciones se aplican a las variables de entorno de la máquina. Si no se establece este bit, las acciones se aplican a las variables de entorno del usuario.
0x40000000	Anexar. Este bit es opcional. No establezca ambos modificadores Append y Prefix.
0x80000000	Prefix. Este bit es opcional. No establezca ambos modificadores Append y Prefix.