WriteEnvironmentStrings-Aktion

Die WriteEnvironmentStrings-Aktion ändert die Werte von Umgebungsvariablen.

Beachten Sie, dass sich Umgebungsvariablen für die laufende Installation nicht ändern, wenn die WriteEnvironmentStrings-Aktion oder die RemoveEnvironmentStrings-Aktion ausgeführt wird. Unter Windows 2000, Windows Server 2003, Windows XP und Windows Vista werden diese Informationen in der Registrierung gespeichert, und es wird eine WM_SETTINGCHANGE-Nachricht gesendet, um das System nach Abschluss der Installation über die Änderungen zu informieren. Ein anderer Prozess kann Benachrichtigungen über die Änderungen erhalten, indem diese Nachrichten verarbeitet werden. Wenn ein Neustart des Systems aussteht, wird keine Nachricht gesendet. Ein Paket kann die MsiSystemRebootPending-Eigenschaft verwenden, um zu überprüfen, ob ein Systemneustart aussteht.

Das Installationsprogramm führt die WriteEnvironmentStrings-Aktion nur während der Installation oder Neuinstallation einer Komponente und die RemoveEnvironmentStrings-Aktion nur beim Entfernen einer Komponente aus.

Werte werden basierend auf der Auswahl primärer Aktionen und Modifizierer geschrieben oder entfernt. Diese werden im Abschnitt „ActionData-Nachrichten“ weiter unten beschrieben. Beachten Sie, dass WriteEnvironmentStrings abhängig von der angegebenen Aktion Variablen entfernen und RemoveEnvironmentStrings Variablen abhängig von der Erstellung der Environment-Tabelle hinzufügen kann.

Sequenzeinschränkungen

Die InstallValidate-Aktion muss vor der RemoveEnvironmentStrings-Aktion ausgeführt werden. Da die WriteEnvironmentStrings-Aktion und die RemoveEnvironmentStrings-Aktion bei einer Installation oder Deinstallation einer Komponente nie beide angewendet werden, ist ihre relative Sequenz nicht eingeschränkt.

ActionData-Nachrichten

Feld	Beschreibung der Aktionsdaten
[1]	Name der zu ändernden Umgebungsvariablen.
[2]	Wert der Umgebungsvariablen.
[3]	Dies ist ein Feld von Bitflags, das die auszuführende Aktion angibt. Fügen Sie für eine primäre Aktion nur ein Bit ein. Dieses Feld kann mehrere Modifiziererbits enthalten. Weitere Informationen finden Sie in den folgenden Bitflagbeschreibungen.

 

Bitwert	Beschreibung der primären Aktionen
0x1	Festlegen. Legt in allen Fällen den Wert der Umgebungsvariable fest. Wenn dieses Bit mit einem Append- oder Prefix-Modifiziererbit kombiniert wird, fügt die Aktion den Wert jedem vorhandenen Wert in der Variablen hinzu.
0x2	Festlegen. Legt den Wert fest, wenn die Variable nicht vorhanden ist. Wenn dieses Bit mit einem Append- oder Prefix-Modifiziererbit kombiniert wird, fügt die Aktion den Wert jedem vorhandenen Wert in der Variablen hinzu.
0x4	Entfernen Entfernt den Wert aus der Variablen. Wenn dieses Bit mit einem Append- oder Prefix-Modifiziererbit kombiniert wird, wird der Wert aus der vorhandenen Zeichenfolge entfernt, sofern der Wert vorhanden ist.

 

Bitwert	Beschreibung des Modifizierers
0x20000000	Wenn dieses Bit gesetzt ist, werden Aktionen auf die Umgebungsvariablen des Computers angewendet. Wenn dieses Bit nicht gesetzt ist, werden Aktionen auf die Umgebungsvariablen der Benutzerin/des Benutzers angewendet.
0x40000000	Anfügen. Dieses Bit ist optional. Legen Sie Append- und Prefix-Modifizierer nicht gleichzeitig fest.
0x80000000	Prefix. Dieses Bit ist optional. Legen Sie Append- und Prefix-Modifizierer nicht gleichzeitig fest.