Tindakan InstallFiles

Tindakan InstallFiles menyalin file yang ditentukan dalam tabel File dari direktori sumber ke direktori tujuan.

Pembatasan Urutan

Tindakan InstallFiles harus muncul setelah tindakan InstallValidate dan sebelum tindakan yang bergantung pada file.

Pesan ActionData

Bidang	Deskripsi data tindakan
[1]	Pengidentifikasi file yang diinstal.
[6]	Ukuran file yang diinstal dalam byte.
[9]	Pengidentifikasi direktori yang menyimpan file yang terinstal.

 

Keterangan

Tindakan InstallFiles beroperasi pada file yang ditentukan dalam tabel File. Setiap file diinstal berdasarkan status penginstalan komponen terkait file dalam tabel Komponen. Hanya file yang komponennya diselesaikan ke status msiInstallStatelocal yang memenuhi syarat untuk disalin.

Tindakan InstallFiles mengimplementasikan kolom tabel File berikut.

• Kolom FileName menentukan nama file target.
• Kolom Versi menentukan versi file.
• Kolom Atribut menentukan file dan bit bendera atribut penginstalan.
• Kolom File menentukan token file unik.
• Kolom FileSize menentukan ukuran file yang tidak dikompresi dalam byte.
• Kolom Bahasa menentukan pengidentifikasi bahasa file.
• Kolom Urutan menentukan nomor urut pada media.

Tindakan InstallFiles mengimplementasikan kolom tabel Komponen berikut.

• Kolom Directory_ menentukan referensi ke item tabel Direktori .
• Kolom Komponen menentukan nama unik untuk item komponen.

File yang ditentukan disalin hanya jika salah satu hal berikut ini benar:

• File saat ini tidak diinstal pada komputer lokal.
• File berada di komputer lokal tetapi memiliki nomor versi yang lebih rendah daripada file dalam tabel File.
• File ada di komputer lokal, tetapi tidak ada nomor versi terkait.

Direktori sumber untuk setiap file yang akan disalin ditentukan oleh sourceMode, yang pada gilirannya bergantung pada nilai di kolom Kabinet tabel Media. Untuk diskusi lengkap tentang mode sumber, lihat tabel Media.

Jika direktori sumber untuk file yang akan disalin berada di media yang dapat dilepas seperti disket atau CD-ROM, tindakan InstallFiles memverifikasi bahwa media sumber yang tepat dimasukkan sebelum mencoba menyalin file. InstallFiles mencari media dengan jenis yang dapat dilepas yang sama dengan label volume yang cocok dengan nilai yang diberikan di kolom VolumeLabel dari tabel Media. Jika volume terpasang yang cocok ditemukan, proses penyalinan file akan dilanjutkan. Jika tidak ada kecocokan yang ditemukan, kotak dialog meminta pengguna untuk menyisipkan media yang tepat. Dalam hal ini, kotak dialog menggunakan nama media yang ditemukan di kolom DiskPrompt dari tabel Media sebagai bagian dari perintah.

Perhatian harus dilakukan karena tindakan InstallFiles dapat menghapus file asli dan tidak menggantinya. Ini terjadi ketika tindakan InstallFiles mengalami kesalahan saat mengganti file yang lebih lama dan pengguna memilih untuk mengabaikan kesalahan. Perilaku default alat penginstal adalah menghapus file lama sebelum memastikan file baru disalin dengan benar.

Untuk aturan penerapan versi file yang digunakan oleh alat penginstal, lihat Aturan Penerapan Versi File.