Bagikan melalui

Tindakan WriteEnvironmentStrings

  • Artikel

Tindakan WriteEnvironmentStrings memodifikasi nilai variabel lingkungan.

Variabel lingkungan tidak berubah untuk penginstalan yang sedang berlangsung ketika tindakan WriteEnvironmentStrings atau tindakan RemoveEnvironmentStrings dijalankan. Pada Windows 2000, Windows Server 2003, Windows XP, dan Windows Vista informasi ini disimpan di registri dan pesan WM_SETTINGCHANGE dikirim untuk memberi tahu sistem tentang perubahan ketika penginstalan selesai. Proses lain dapat menerima pemberitahuan tentang perubahan dengan menangani pesan-pesan ini. Tidak ada pesan yang dikirim jika mulai ulang sistem tertunda. Paket dapat menggunakan properti MsiSystemRebootPending untuk memeriksa apakah hidupkan ulang sistem tertunda.

Alat penginstal menjalankan tindakan WriteEnvironmentStrings hanya selama penginstalan atau penginstalan ulang komponen, dan menjalankan tindakan RemoveEnvironmentStrings hanya selama penghapusan komponen.

Nilai ditulis atau dihapus berdasarkan pemilihan tindakan utama dan pengubah. Ini dijelaskan di bagian Pesan ActionData berikut. Perhatikan bahwa tergantung pada tindakan yang ditentukan, WriteEnvironmentStrings dapat menghapus variabel, dan RemoveEnvironmentStrings dapat menambahkannya berdasarkan penulisan tabel Lingkungan.

Pembatasan Urutan

Tindakan InstallValidate harus dijalankan sebelum tindakan RemoveEnvironmentStrings. Karena tindakan WriteEnvironmentStrings dan tindakan RemoveEnvironmentStrings tidak pernah diterapkan selama penginstalan atau penghapusan komponen, urutan relatifnya tidak dibatasi.

Pesan ActionData

Bidang Deskripsi data tindakan
[1] Nama variabel lingkungan yang akan dimodifikasi.
[2] Nilai variabel lingkungan.
[3] Ini adalah bidang bendera bit yang menentukan tindakan yang akan dilakukan. Sertakan hanya satu bit untuk tindakan utama. Mungkin ada lebih dari satu bit pengubah yang disertakan dalam bidang ini. Lihat deskripsi bendera bit berikut.

 

Nilai Bit Deskripsi tindakan utama
0x1 Set. Mengatur nilai variabel lingkungan dalam semua kasus.
Jika bit ini dikombinasikan dengan bit pengubah Tambahkan atau Awalan, tindakan menambahkan nilai ke nilai yang ada dalam variabel.
0x2 Set. Mengatur nilai jika variabel tidak ada.
Jika bit ini dikombinasikan dengan bit pengubah Tambahkan atau Awalan, tindakan menambahkan nilai ke nilai yang ada dalam variabel.
0x4 Menghapus. Menghapus nilai dari variabel.
Jika bit ini dikombinasikan dengan bit pengubah Tambahkan atau Awalan, nilai dihapus dari string yang ada, jika nilai ada.

 

Nilai Bit Deskripsi pengubah
0x20000000 Jika bit ini diatur, tindakan diterapkan ke variabel lingkungan komputer.
Jika bit ini tidak diatur, tindakan diterapkan ke variabel lingkungan pengguna.
0x40000000 Menambahkan. Bit ini bersifat opsional. Jangan atur pengubah Tambahkan dan Awalan.
0x80000000 Awalan. Bit ini bersifat opsional. Jangan atur pengubah Tambahkan dan Awalan.