Tabel MsiEmbeddedUI

Tabel MsiEmbeddedUI menentukan antarmuka pengguna yang disematkan dalam paket Pemasang Windows.

Pemasang Windows 4.0 atau yang lebih lama: Tidak didukung. Tabel ini tersedia dimulai dengan Pemasang Windows 4.5.

Tabel MsiEmbeddedUI memiliki kolom berikut.

Kolom	Jenis	Kunci	Dapat diubah ke null
MsiEmbeddedUI	Pengidentifikasi	Y	N
FileName	Teks	N	N
Atribut	Bilangan bulat	N	N
MessageFilter	Bilangan Bulat Ganda	N	Y
Data	Biner	N	N

 

Kolom

MsiEmbeddedUI

Kunci primer untuk tabel.

Filename

Nama file yang menerima informasi biner di kolom Data. Nama file diperlukan untuk menyertakan ekstensi. Misalnya, nama embeddedui.dll dapat diterima, tetapi embeddedui tidak dapat diterima. Nama dapat dilokalkan. Bidang ini bisa berisi nama file pendek atau nama file panjang, tetapi tidak boleh berisi keduanya. Format bidang ini seperti tipe data kolom Nama file kecuali bahwa pemisah bilah vertikal (|) untuk sintaks nama file pendek/nama file panjang tidak tersedia. Karena beberapa server web dapat peka huruf besar/kecil, FileName harus cocok dengan kasus file sumber persis untuk memastikan dukungan unduhan Internet.

Atribut

Informasi tentang data di kolom Data. Nilai dalam bidang ini bisa berisi satu atau beberapa konstanta berikut.

Terus-menerus	Heksadesimal	Desimal	Makna
Tidak ada	0x00	0	File bukan file DLL untuk antarmuka pengguna. Ini mungkin file sumber daya yang digunakan oleh antarmuka pengguna.
msidbEmbeddedUI	0x01	1	File DLL utama untuk antarmuka pengguna. Tidak lebih dari satu baris dalam tabel dapat ditandai dengan atribut ini. Jika beberapa baris ditandai dengan atribut ini, itu adalah kesalahan dan tidak dapat dijamin DLL mana yang digunakan.
msidbEmbeddedHandlesBasic	0x02	2	Memungkinkan alat penginstal untuk memanggil UI yang disematkan selama penginstalan tingkat antarmuka pengguna dasar. Alat penginstal mengabaikan atribut ini jika tidak dikombinasikan dengan atribut msidbEmbeddedUI .

 

MessageFilter

Menentukan jenis pesan yang dikirim ke DLL antarmuka pengguna. Kolom ini hanya relevan untuk baris dengan atribut msidbEmbeddedUI . Bidang ini harus null jika baris mereferensikan file sumber daya dan nilai Atribut null. Jika baris mereferensikan DLL antarmuka pengguna, nilai dalam kolom ini tidak boleh null.

Nilai dalam kolom ini bisa menjadi kombinasi dari nilai berikut. Alat penginstal mengabaikan nilai lain.

Terus-menerus	Heksadesimal	Desimal	Deskripsi
INSTALLLOGMODE_FATALEXIT	0x00001	1	Penghentian dini.
INSTALLLOGMODE_ERROR	0x00002	2	Pesan kesalahan.
INSTALLLOGMODE_WARNING	0x00004	4	Pesan peringatan.
INSTALLLOGMODE_USER	0x00008	8	Pesan pengguna.
INSTALLLOGMODE_INFO	0x00010	16	Pesan status tidak di-log.
INSTALLLOGMODE_FILESINUSE	0x00020	32	File yang saat ini sedang digunakan.
INSTALLLOGMODE_RESOLVESOURCE	0x00040	64	Permintaan resolusi sumber.
INSTALLLOGMODE_OUTOFDISKSPACE	0x00080	128	Pesan ruang disk.
INSTALLLOGMODE_ACTIONSTART	0x00100	256	Tindakan memulai pesan.
INSTALLLOGMODE_ACTIONDATA	0x00200	512	Pesan data tindakan.
INSTALLLOGMODE_PROGRESS	0x00400	1024	Pesan kemajuan.
INSTALLLOGMODE_COMMONDATA	0x00800	2048	Pesan inisialisasi UI.
INSTALLLOGMODE_INITIALIZE	0x01000	4096	Pesan startup UI yang dikirim saat penginstalan produk dimulai.
INSTALLLOGMODE_TERMINATE	0x02000	8192	Pesan pematian UI yang dikirim setelah penginstalan produk selesai.
INSTALLLOGMODE_SHOWDIALOG	0x04000	16384	Pesan yang dikirim sebelum tampilan dialog UI.
INSTALLLOGMODE_RMFILESINUSE	0x02000000	33554432	File yang saat ini sedang digunakan.
INSTALLLOGMODE_INSTALLSTART	0x04000000	67108864	Penginstalan produk dimulai. Pesan berisi ProductName dan ProductCode produk.
INSTALLLOGMODE_INSTALLEND	0x08000000	134217728	Penginstalan produk berakhir. Pesan berisi ProductName, ProductCode, dan nilai pengembalian produk.

 

Data

Kolom ini berisi informasi biner. Jika bidang Atribut ditandai dengan atribut msidbEmbeddedUI , informasi di bidang ini harus dll. Jika bidang Atribut bukan atribut msidbEmbeddedUI , informasi di bidang ini dapat menjadi file sumber daya dalam format apa pun.

Keterangan

Untuk menggunakan antarmuka pengguna yang disematkan, pengembang penyiapan harus menulis fungsionalitas ini ke dalam paket Pemasang Windows. Tabel MsiEmbeddedUI menentukan antarmuka pengguna yang disematkan. DLL untuk UI yang disematkan harus mengekspor fungsi InitializeEmbeddedUI, EmbeddedUIHandler, dan ShutdownEmbeddedUI . Paket yang tidak mendukung antarmuka pengguna yang disematkan dapat menggunakan antarmuka pengguna internal Pemasang Windows.

Untuk menjalankan Alat Penelusuran Kesalahan untuk Windows pada antarmuka pengguna yang disematkan, gunakan teknik yang dijelaskan dalam Men-debug Tindakan Kustom. Tetapkan nilai MsiBreak ke MsiEmbeddedUI.

Untuk contoh UI kustom yang disematkan, lihat Menggunakan UI Tersemat.