WriteEnvironmentStrings művelet
A WriteEnvironmentStrings művelet módosítja a környezeti változók értékeit.
A folyamatban lévő telepítés környezeti változói nem változnak a WriteEnvironmentStrings művelet vagy RemoveEnvironmentStrings művelet futtatásakor,. Windows 2000, Windows Server 2003, Windows XP és Windows Vista rendszeren ez az információ a beállításjegyzékben lesz tárolva, és a rendszer egy WM_SETTINGCHANGE üzenetet küld, amely értesíti a rendszert a telepítés befejeződésekor bekövetkező változásokról. Egy másik folyamat ezen üzenetek kezelésével értesítést kaphat a változásokról. A rendszer nem küld üzenetet, ha a rendszer újraindítása függőben van. A csomagok az MsiSystemRebootPending tulajdonság használatával ellenőrizhetik, hogy a rendszer újraindítása függőben van-e.
A telepítő csak egy összetevő telepítése vagy újratelepítése során futtatja a WriteEnvironmentStrings műveletet, és a RemoveEnvironmentStrings műveletet csak egy összetevő eltávolítása során futtatja.
Az értékek írása vagy törlése az alapműveletek és módosítók kiválasztása alapján történik. Ezeket az alábbi ActionData-üzenetek szakaszban ismertetjük. Vegye figyelembe, hogy a megadott művelettől függően a WriteEnvironmentStrings eltávolíthatja a változókat, a RemoveEnvironmentStrings pedig hozzáadhatja őket, az környezeti táblaalapján.
Sorozatkorlátozások
Az InstallValidate műveletet a RemoveEnvironmentStrings művelet előtt kell végrehajtani. Mivel a WriteEnvironmentStrings művelet és a RemoveEnvironmentStrings művelet soha nem lesz alkalmazva az összetevők telepítése vagy eltávolítása során, a relatív sorrendjük nincs korlátozva.
ActionData-üzenetek
Mező | A műveleti adatok leírása |
---|---|
[1] | A módosítani kívánt környezeti változó neve. |
[2] | A környezeti változó értéke. |
[3] | Ez a bitjelölők mezője határozza meg a végrehajtandó műveletet. Tartalmazzon csak egy bitet egy elsődleges művelet esetén. Ebben a mezőben több módosító bit is szerepelhet. Tekintse meg a következő bitjelölők leírását. |
Bitérték | Az elsődleges műveletek leírása |
---|---|
0x1 | Beállít. A környezeti változó értékét minden esetben beállítja. Ha ezt a bitet hozzáfűző vagy előtag módosító bittel kombinálja, a művelet hozzáadja az értéket a változó bármely meglévő értékéhez. |
0x2 | Beállít. Beállítja az értéket, ha a változó hiányzik. Ha ezt a bitet hozzáfűző vagy előtag módosító bittel kombinálja, a művelet hozzáadja az értéket a változó bármely meglévő értékéhez. |
0x4 | Eltávolít. Eltávolítja az értéket a változóból. Ha ezt a bitet hozzáfűző vagy előtag módosító bittel kombinálják, a rendszer eltávolítja az értéket a meglévő sztringből, ha létezik ilyen érték. |
Bitérték | A módosító leírása |
---|---|
0x20000000 | Ha ez a bit be van állítva, a rendszer műveleteket alkalmaz a gép környezeti változóira. Ha ez a bit nincs beállítva, a rendszer műveleteket alkalmaz a felhasználó környezeti változóira. |
0x40000000 | Hozzáfűz. Ez a rész nem kötelező. Ne állítsa be a hozzáfűző és az előtag módosító elemét sem. |
0x80000000 | Előtag Ez a bit nem kötelező. Ne állítsa be a hozzáfűző és az előtag módosító elemét sem. |