Bagikan melalui

Tabel MsiEmbeddedUI

  • Artikel

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.