Fungsi MsiSetInternalUI memungkinkan antarmuka pengguna internal penginstal. Kemudian antarmuka pengguna ini digunakan untuk semua panggilan berikutnya ke fungsi alat penginstal yang menghasilkan antarmuka pengguna dalam proses ini. Untuk informasi selengkapnya, lihat Tingkat Antarmuka Pengguna.
Menentukan tingkat kompleksitas antarmuka pengguna. Parameter ini bisa menjadi salah satu nilai berikut.
Nilai
Makna
INSTALLUILEVEL_FULL
Antarmuka pengguna yang ditulis dengan wizard, kemajuan, dan kesalahan.
INSTALLUILEVEL_REDUCED
Antarmuka pengguna yang ditulis dengan kotak dialog wizard ditekan.
INSTALLUILEVEL_BASIC
Kemajuan sederhana dan penanganan kesalahan.
INSTALLUILEVEL_DEFAULT
Alat penginstal memilih tingkat antarmuka pengguna yang sesuai.
INSTALLUILEVEL_NONE
Penginstalan yang benar-benar senyap. Ini termasuk menekan prompt elevasi bahkan jika diperlukan. Lihat INSTALLUILEVEL_UACONLY apakah Anda ingin pengguna dapat meningkatkan.
INSTALLUILEVEL_ENDDIALOG
Jika dikombinasikan dengan nilai di atas, alat penginstal menampilkan kotak dialog modal di akhir penginstalan yang berhasil atau jika ada kesalahan. Tidak ada kotak dialog yang ditampilkan jika pengguna membatalkan.
INSTALLUILEVEL_PROGRESSONLY
Jika dikombinasikan dengan nilai INSTALLUILEVEL_BASIC , alat penginstal memperlihatkan kotak dialog kemajuan sederhana tetapi tidak menampilkan kotak dialog modal atau kotak dialog kesalahan.
INSTALLUILEVEL_NOCHANGE
Tidak ada perubahan pada tingkat UI. Namun, jika phWnd bukan Null, jendela induk dapat berubah.
INSTALLUILEVEL_HIDECANCEL
Jika dikombinasikan dengan nilai INSTALLUILEVEL_BASIC , alat penginstal memperlihatkan kotak dialog kemajuan sederhana tetapi tidak menampilkan tombol Batal pada dialog. Ini mencegah pengguna membatalkan penginstalan.
INSTALLUILEVEL_SOURCERESONLY
Jika nilai ini dikombinasikan dengan nilai INSTALLUILEVEL_NONE , alat penginstal hanya menampilkan kotak dialog yang digunakan untuk resolusi sumber. Tidak ada kotak dialog lain yang ditampilkan. Nilai ini tidak berpengaruh jika tingkat UI tidak INSTALLUILEVEL_NONE. Ini digunakan dengan antarmuka pengguna eksternal yang dirancang untuk menangani semua UI kecuali untuk resolusi sumber. Dalam hal ini, alat penginstal menangani resolusi sumber.
INSTALLUILEVEL_UACONLY
Jika dikombinasikan dengan nilai INSTALLUILEVEL_NONE , penginstalan akan sepenuhnya senyap kecuali untuk permintaan elevasi jika diperlukan.
[in, out] phWnd
Arahkan ke jendela. Jendela ini menjadi pemilik antarmuka pengguna apa pun yang dibuat. Penunjuk ke pemilik sebelumnya dari antarmuka pengguna dikembalikan. Jika parameter ini null, pemilik antarmuka pengguna tidak berubah.
Nilai kembali
Tingkat antarmuka pengguna sebelumnya dikembalikan. Jika dwUILevel yang tidak valid diteruskan, maka INSTALLUILEVEL_NOCHANGE dikembalikan.
Keterangan
Fungsi MsiSetInternalUI berguna ketika alat penginstal harus menampilkan antarmuka pengguna. Misalnya, jika fitur diinstal, tetapi sumbernya adalah disk ringkas yang harus dimasukkan, penginstal meminta pengguna untuk disk ringkas. Bergantung pada sifat penginstalan, aplikasi mungkin juga menampilkan indikator kemajuan atau meminta informasi kepada pengguna.
Ketika Msi.dll dimuat, tingkat antarmuka pengguna diatur ke DEFAULT dan pemilik antarmuka pengguna diatur ke 0 (yaitu, pemilik antarmuka pengguna awal adalah desktop).
Persyaratan
Klien minimum yang didukung
Windows Installer 5.0 di Windows Server 2012, Windows 8, Windows Server 2008 R2 atau Windows 7. Windows Installer 4.0 atau Windows Installer 4.5 di Windows Server 2008 atau Windows Vista. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Pemasang Windows.