Fungsi MsiSetInternalUI (msi.h)

  • Artikel

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.

Sintaks

INSTALLUILEVEL MsiSetInternalUI(
  [in]      INSTALLUILEVEL dwUILevel,
  [in, out] HWND           *phWnd
);

Parameter

[in] dwUILevel

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.
Target Platform Windows
Header msi.h
Pustaka Msi.lib
DLL Msi.dll

Lihat juga

Fungsi Antarmuka dan Pengelogan