Delen via

Actie WriteEnvironmentStrings

  • Artikel

Met de actie WriteEnvironmentStrings worden de waarden van omgevingsvariabelen gewijzigd.

Omgevingsvariabelen worden niet gewijzigd voor de installatie die wordt uitgevoerd wanneer de actie WriteEnvironmentStrings of de actie RemoveEnvironmentStrings wordt uitgevoerd. Op Windows 2000, Windows Server 2003, Windows XP en Windows Vista wordt deze informatie opgeslagen in het register en wordt een WM_SETTINGCHANGE bericht verzonden om het systeem op de hoogte te stellen van de wijzigingen wanneer de installatie is voltooid. Een ander proces kan een melding van de wijzigingen ontvangen door deze berichten te verwerken. Er wordt geen bericht verzonden als er een herstart van het systeem wacht. Een pakket kan de eigenschap MsiSystemRebootPending gebruiken om te controleren of een systeemherstart nodig is.

Het installatieprogramma voert de actie WriteEnvironmentStrings alleen uit tijdens de installatie of het opnieuw installeren van een onderdeel en voert de actie RemoveEnvironmentStrings- actie alleen uit tijdens het verwijderen van een onderdeel.

Waarden worden geschreven of verwijderd op basis van de selectie van primaire acties en modifiers. Deze worden beschreven in de volgende sectie ActionData-berichten. Houd er rekening mee dat, afhankelijk van de opgegeven actie, `WriteEnvironmentStrings` variabelen kan verwijderen en `RemoveEnvironmentStrings` deze kan toevoegen op basis van de samenstelling van de Omgevingstabel.

Sequentiebeperkingen

De actie InstallValidate moet worden uitgevoerd vóór de actie RemoveEnvironmentStrings. Omdat de actie WriteEnvironmentStrings en de actie RemoveEnvironmentStrings nooit beide worden toegepast tijdens een installatie of verwijdering van een onderdeel, is hun relatieve volgorde niet beperkt.

ActionData-berichten

Veld Beschrijving van actiegegevens
[1] Naam van de omgevingsvariabele die u wilt wijzigen.
[2] De waarde van de omgevingsvariabele.
[3] Dit is een veld met bitvlagmen waarmee de actie wordt opgegeven die moet worden uitgevoerd. Neem slechts één bit op voor een primaire actie. Er is mogelijk meer dan één wijzigingsbit opgenomen in dit veld. Zie de volgende bitvlagbeschrijvingen.

 

Bitwaarde Beschrijving van primaire acties
0x1 Instellen Hiermee stelt u de waarde van de omgevingsvariabele in alle gevallen in.
Als deze bit wordt gecombineerd met een wijzigingsbit voor toevoegen of voorvoegsel, voegt de actie de waarde toe aan een bestaande waarde in de variabele.
0x2 Instellen. Hiermee stelt u de waarde in als de variabele afwezig is.
Als deze bit wordt gecombineerd met een wijzigingsbit voor toevoegen of voorvoegsel, voegt de actie de waarde toe aan een bestaande waarde in de variabele.
0x4 Verwijderen. Hiermee verwijdert u de waarde uit de variabele.
Als deze bit wordt gecombineerd met een wijzigingsbit voor toevoeg- of voorvoegsel, wordt de waarde verwijderd uit de bestaande tekenreeks, als de waarde bestaat.

 

Bitwaarde Beschrijving van wijzigingsfunctie
0x20000000 Als deze bit is ingesteld, worden acties toegepast op de omgevingsvariabelen van de machine.
Als deze bit niet is ingesteld, worden acties toegepast op de omgevingsvariabelen van de gebruiker.
0x40000000 Toevoegen. Deze bit is optioneel. Stel zowel de Append- als de Prefix-modificaties niet in.
0x80000000 Voorvoegsel. Deze bit is optioneel. Stel niet zowel de toevoeg- als de voorvoegmodificatoren in.