Freigeben über


RemoveEnvironmentStrings-Aktion

Die RemoveEnvironmentStrings-Aktion ändert die Werte von Umgebungsvariablen.

Beachten Sie, dass sich Umgebungsvariablen für die laufende Installation nicht ändern, wenn entweder die Aktion WriteEnvironmentStrings oder RemoveEnvironmentStrings ausgeführt wird. Unter Windows 2000 werden diese Informationen in der Registrierung gespeichert, und es wird nach Abschluss der Installation eine Nachricht gesendet, um das System über Änderungen zu informieren. Ein neuer oder anderer Prozess, der nach diesen Nachrichten sucht, verwendet die neuen Umgebungsvariablen.

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, die die auszuführende Aktion angeben. 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.