Akcja RemoveEnvironmentStrings

Akcja RemoveEnvironmentStrings modyfikuje wartości zmiennych środowiskowych.

Należy pamiętać, że zmienne środowiskowe nie zmieniają się w toku podczas uruchamiania akcji WriteEnvironmentStrings lub RemoveEnvironmentStrings. W systemie Windows 2000 te informacje są przechowywane w rejestrze, a komunikat jest wysyłany w celu powiadomienia systemu o zmianach po zakończeniu instalacji. Nowy proces lub inny proces, który sprawdza te komunikaty, będzie używać nowych zmiennych środowiskowych.

Instalator uruchamia akcję WriteEnvironmentStrings tylko podczas instalacji lub ponownej instalacji składnika i uruchamia akcję RemoveEnvironmentStrings tylko podczas usuwania składnika.

Wartości są zapisywane lub usuwane na podstawie wyboru akcji podstawowych i modyfikatorów. Są one opisane w poniższej sekcji ActionData Messages. Należy pamiętać, że w zależności od określonej akcji funkcja WriteEnvironmentStrings może usuwać zmienne, a polecenia RemoveEnvironmentStrings mogą je dodawać na podstawie tworzenia tabeli środowiska .

Ograniczenia sekwencji

Przed akcją RemoveEnvironmentStrings należy wykonać akcję InstallValidate. Ponieważ akcja WriteEnvironmentStrings i Akcja RemoveEnvironmentStrings nigdy nie są stosowane podczas instalacji lub usuwania składnika, ich sekwencja względna nie jest ograniczona.

Komunikaty ActionData

Pole	Opis danych akcji
[1]	Nazwa zmiennej środowiskowej do zmodyfikowania.
[2]	Wartość zmiennej środowiskowej.
[3]	Jest to pole flag bitowych, które określają akcję do wykonania. Uwzględnij tylko jeden bit dla akcji podstawowej. W tym polu może znajdować się więcej niż jeden bit modyfikatora. Zobacz następujące opisy flag bitowych.

 

Wartość bitowa	Opis akcji podstawowych
0x1	Zbiór. Ustawia wartość zmiennej środowiskowej we wszystkich przypadkach. Jeśli ten bit jest połączony z bitem modyfikatora dołączania lub prefiksu, akcja dodaje wartość do dowolnej istniejącej wartości w zmiennej.
0x2	Zbiór. Ustawia wartość, jeśli zmienna jest nieobecna. Jeśli ten bit jest połączony z bitem modyfikatora dołączania lub prefiksu, akcja dodaje wartość do dowolnej istniejącej wartości w zmiennej.
0x4	Usunąć. Usuwa wartość ze zmiennej. Jeśli ten bit jest połączony z bitem modyfikatora dołączania lub prefiksu, wartość zostanie usunięta z istniejącego ciągu, jeśli wartość istnieje.

 

Wartość bitowa	Opis modyfikatora
0x20000000	Jeśli ten bit jest ustawiony, akcje są stosowane do zmiennych środowiskowych maszyny. Jeśli ten bit nie jest ustawiony, akcje są stosowane do zmiennych środowiskowych użytkownika.
0x40000000	Dołączyć. Ten bit jest opcjonalny. Nie należy ustawiać zarówno modyfikatorów dołączania, jak i prefiksu.
0x80000000	Przedrostek. Ten bit jest opcjonalny. Nie należy ustawiać zarówno modyfikatorów dołączania, jak i prefiksu.