OrtamDizgileriYazma İşlemi

WriteEnvironmentStrings eylemi, ortam değişkenlerinin değerlerini değiştirir.

WriteEnvironmentStrings eylemi veya RemoveEnvironmentStrings eylemleri çalıştırıldığında, ortam değişkenleri devam eden yükleme için değişmez. Windows 2000, Windows Server 2003, Windows XP ve Windows Vista'da bu bilgiler kayıt defterinde depolanır ve yükleme tamamlandığında sisteme değişiklikleri bildirmek için bir WM_SETTINGCHANGE iletisi gönderilir. Başka bir işlem, bu iletileri işleyerek değişikliklerin bildirimini alabilir. Sistemin yeniden başlatılması bekleniyorsa ileti gönderilmez. Bir paket, sistemin yeniden başlatılmasının beklemede olup olmadığını denetlemek için MsiSystemRebootPending özelliğini kullanabilir.

Yükleyici WriteEnvironmentStrings eylemini yalnızca bir bileşenin yüklenmesi veya yeniden yüklenmesi sırasında çalıştırır ve RemoveEnvironmentStrings eylemini yalnızca bir bileşenin kaldırılması sırasında çalıştırır.

Değerler, birincil eylemlerin ve değiştiricilerin seçimine göre yazılır veya kaldırılır. Bunlar aşağıdaki ActionData İletileri bölümünde açıklanmıştır. Belirtilen eyleme bağlı olarak, WriteEnvironmentStrings'in değişkenleri kaldırabileceğini ve RemoveEnvironmentStrings'in Ortam tablosununyazma temelinde bunları ekleyebileceğini unutmayın.

Sıra Kısıtlamaları

InstallValidate eylemi RemoveEnvironmentStrings eyleminden önce yürütülmelidir. WriteEnvironmentStrings eylemi ve RemoveEnvironmentStrings eylemi hiçbir zaman bir bileşenin yüklenmesi veya kaldırılması sırasında uygulanmadığından, göreli dizisi kısıtlanmaz.

ActionData İletileri

Alan	Eylem verilerinin açıklaması
[1]	Değiştirileceği ortam değişkeninin adı.
[2]	Ortam değişkeni değeri.
[3]	Bu, gerçekleştirilecek eylemi belirten bit bayrakları alanıdır. Sadece birincil eylem için bir bit ekleyin. Bu alana birden fazla değiştirici bit eklenebilir. Aşağıdaki bit bayrağı açıklamalarına bakın.

 

Bit Değeri	Birincil eylemlerin açıklaması
0x1	Ayarlamak. Her durumda ortam değişkeninin değerini ayarlar. Eğer bu bit bir ekleme veya önek değiştirici biti ile birleştirilirse, işlem değeri değişkendeki mevcut herhangi bir değere ekler.
0x2	Ayarlamak. Değişken yoksa değeri ayarlar. Bu bit Bir Ekleme veya Önek değiştirici biti ile birleştirilirse, eylem değeri değişkendeki mevcut değerlere ekler.
0x4	Kaldır. Değişkenden değeri kaldırır. Bu bit bir Ekleme veya Önek değiştirici biti ile birleştirilirse, değer varsa mevcut dizeden kaldırılır.

 

Bit Değeri	Değiştiricinin açıklaması
0x20000000	Bu bit ayarlanırsa, eylemler makine ortamı değişkenlerine uygulanır. Bu bit ayarlanmadıysa, eylemler kullanıcının ortam değişkenlerine uygulanır.
0x40000000	Ekle. Bu bit isteğe bağlıdır. Hem Ekle hem de Önek değiştiricilerini ayarlamayın.
0x80000000	Önek. Bu bit isteğe bağlıdır. Hem Ekle hem de Önek değiştiricilerini ayarlamayın.