Sdílet prostřednictvím

Akce „WriteEnvironmentStrings“

  • Článek

Akce WriteEnvironmentStrings upravuje hodnoty proměnných prostředí.

Proměnné prostředí se během probíhající instalace nezmění, když jsou spuštěny akce WriteEnvironmentStrings nebo RemoveEnvironmentStrings. V systému Windows 2000, Windows Server 2003, Windows XP a Windows Vista jsou tyto informace uloženy v registru a zpráva WM_SETTINGCHANGE je odeslána s upozorněním na systém změn po dokončení instalace. Další proces může přijímat oznámení o změnách zpracováním těchto zpráv. Pokud je restartování systému čekající, žádná zpráva se neposílá. Balíček může použít vlastnost MsiSystemRebootPending a zkontrolovat, jestli čeká na restartování systému.

Instalační program spustí akci WriteEnvironmentStrings pouze během instalace nebo přeinstalace komponenty a spustí akci RemoveEnvironmentStrings pouze během odebrání komponenty.

Hodnoty se zapisují nebo odebírají na základě výběru primárních akcí a modifikátorů. Jsou popsány v následující části Zprávy ActionData. Všimněte si, že v závislosti na zadané akci může WriteEnvironmentStrings odebrat proměnné a RemoveEnvironmentStrings je může přidat na základě vytváření tabulky Environment.

Omezení posloupnosti

Před akcí RemoveEnvironmentStrings je nutné provést akci InstallValidate. Vzhledem k tomu, že akce WriteEnvironmentStrings a RemoveEnvironmentStrings nejsou nikdy použity při instalaci nebo odebrání komponenty, jejich relativní sekvence není omezena.

Zprávy ActionData

Pole Popis dat akcí
[1] Název proměnné prostředí, která se má upravit.
[2] Hodnota proměnné prostředí.
[3] Toto je pole bitových příznaků, které určuje akci, která se má provést. Zahrnout pouze jeden bit pro hlavní operaci. V tomto poli může být součástí více modifikačních bitů. Podívejte se na následující popis bitových příznaků.

 

Bitová hodnota Popis primárních akcí
0x1 Nastavit. Nastaví hodnotu proměnné prostředí ve všech situacích.
Pokud se tento bit zkombinuje s modifikátorem připojení ('Append') nebo modifikátorem předpony ('Prefix'), daná akce přidá hodnotu k jakékoli existující hodnotě v proměnné.
0x2 Nastavit. Nastaví hodnotu, pokud proměnná chybí.
Pokud se tento bit zkombinuje s modifikátorem připojení nebo předpony, akce přidá hodnotu k jakékoli existující hodnotě v proměnné.
0x4 Odstranit. Odebere hodnotu z proměnné.
Pokud se tento bit zkombinuje s bitem modifikátoru přípony nebo předpony, je hodnota odebrána z existujícího řetězce, pokud hodnota existuje.

 

Bitová hodnota Popis modifikátoru
0x20000000 Pokud je tento bit nastavený, akce se použijí na proměnné prostředí počítače.
Pokud tento bit není nastavený, akce se použijí na proměnné prostředí uživatele.
0x40000000 Připojit. Tento bit je volitelný. Nenastavujte modifikátory připojení i předpony.
0x80000000 Předpona. Tento bit je volitelný. Nenastavujte oba modifikátory Připojit a Předponu.