Udostępnij za pośrednictwem

Akcja WriteEnvironmentStrings

  • Artykuł

Akcja WriteEnvironmentStrings modyfikuje wartości zmiennych środowiskowych.

Zmienne środowiskowe nie zmieniają się podczas instalacji w toku, gdy uruchamiana jest akcja WriteEnvironmentStrings lub akcja RemoveEnvironmentStrings. W systemie Windows 2000, Windows Server 2003, Windows XP i Windows Vista te informacje są przechowywane w rejestrze, a komunikat WM_SETTINGCHANGE jest wysyłany w celu powiadomienia systemu o zmianach po zakończeniu instalacji. Inny proces może odbierać powiadomienia o zmianach, obsługując te komunikaty. W przypadku oczekiwania na ponowne uruchomienie systemu nie jest wysyłany żaden komunikat. Pakiet może używać właściwości MsiSystemRebootPending, aby sprawdzić, czy system oczekuje na ponowne uruchomienie.

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 funkcja RemoveEnvironmentStrings może je dodawać na podstawie specyfikacji tabeli środowiska .

Ograniczenia sekwencji

Akcja InstallValidate musi zostać wykonana przed akcją RemoveEnvironmentStrings. Ponieważ akcja WriteEnvironmentStrings i Akcja RemoveEnvironmentStrings nigdy nie są stosowane podczas instalowania 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 bitowych flag, które określa działanie do wykonania. Uwzględnij tylko jeden bit dla podstawowego działania. 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 Zestaw. 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 Zestaw. Ustawia wartość, jeśli zmienna jest nieobecna.
Jeśli ten bit jest połączony z bitem modyfikatora dołączania lub prefiksu, działanie polega na dodaniu wartości do każdej 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.