Dela via

WriteEnvironmentStrings-åtgärd

  • Artikel

Åtgärden WriteEnvironmentStrings ändrar värdena för miljövariabler.

Miljövariabler ändras inte för installationen som pågår när åtgärden WriteEnvironmentStrings eller RemoveEnvironmentStrings-åtgärden körs. I Windows 2000, Windows Server 2003, Windows XP och Windows Vista lagras den här informationen i registret och ett WM_SETTINGCHANGE meddelande skickas för att meddela systemet om ändringarna när installationen är klar. En annan process kan ta emot meddelanden om ändringarna genom att hantera dessa meddelanden. Inget meddelande skickas om en omstart av systemet väntar. Ett paket kan använda egenskapen MsiSystemRebootPending för att kontrollera om en systemomstart väntar.

Installationsprogrammet kör åtgärden WriteEnvironmentStrings endast under installationen eller ominstallationen av en komponent och kör åtgärden RemoveEnvironmentStrings endast under borttagningen av en komponent.

Värden skrivs eller tas bort baserat på valet av primära åtgärder och modifierare. Dessa beskrivs i avsnittet ActionData-meddelanden. Observera att WriteEnvironmentStrings kan ta bort variabler beroende på vilken åtgärd som anges, och RemoveEnvironmentStrings kan lägga till dem baserat på redigeringen av tabellen Environment.

Sekvensbegränsningar

Åtgärden InstallValidate måste köras innan åtgärden RemoveEnvironmentStrings. Eftersom åtgärden WriteEnvironmentStrings och Åtgärden RemoveEnvironmentStrings aldrig tillämpas både under en installation eller borttagning av en komponent begränsas inte deras relativa sekvens.

ActionData-meddelanden

Fält Beskrivning av åtgärdsdata
[1] Namnet på miljövariabeln som ska ändras.
[2] Miljövariabelvärdet.
[3] Det här är ett fält med bitflaggor som anger vilken åtgärd som ska utföras. Inkludera bara en komponent för en primär åtgärd. Det kan finnas fler än en modifierarbit som ingår i det här fältet. Se följande beskrivningar av bitflaggan.

 

Bitvärde Beskrivning av primära åtgärder
0x1 Sätta. Anger värdet för miljövariabeln i alla fall.
Om den här biten kombineras med en tilläggs- eller prefixmodifierare lägger åtgärden till värdet till alla befintliga värden i variabeln.
0x2 Set. Anger värdet om variabeln saknas.
Om den här biten kombineras med en tilläggs- eller prefixmodifierare lägger åtgärden till värdet till alla befintliga värden i variabeln.
0x4 Avlägsna. Tar bort värdet från variabeln.
Om den här biten kombineras med en tilläggs- eller prefixmodifierare tas värdet bort från den befintliga strängen, om värdet finns.

 

Bitvärde Beskrivning av modifierare
0x20000000 Om den här biten anges tillämpas åtgärder på datormiljövariablerna.
Om den här biten inte har angetts tillämpas åtgärder på användarens miljövariabler.
0x40000000 Lägg till Den här biten är valfri. Ange inte både tilläggs- och prefixmodifierarna.
0x80000000 Prefix. Den här biten är valfri. Ange inte både tilläggs- och prefixmodifierarna.