Fungsi MsiSetExternalUIRecord (msi.h)
Fungsi MsiSetExternalUIRecord memungkinkan handler antarmuka pengguna (UI) eksternal.
Sintaks
UINT MsiSetExternalUIRecord(
[in] INSTALLUI_HANDLER_RECORD puiHandler,
[in] DWORD dwMessageFilter,
[in] LPVOID pvContext,
[out, optional] PINSTALLUI_HANDLER_RECORD ppuiPrevHandler
);
Parameter
[in] puiHandler
Menentukan fungsi panggilan balik yang sesuai dengan spesifikasi INSTALLUI_HANDLER_RECORD .
Untuk menonaktifkan handler UI eksternal saat ini, panggil fungsi dengan parameter ini yang diatur ke nilai NULL .
[in] dwMessageFilter
Menentukan pesan mana yang akan ditangani menggunakan penangan pesan eksternal. Jika handler eksternal mengembalikan hasil bukan nol, maka pesan tersebut tidak dikirim ke UI, sebaliknya pesan dicatat jika pengelogan diaktifkan. Untuk informasi selengkapnya, lihat MsiEnableLog.
| Nilai | Makna |
|---|---|
|
File yang digunakan informasi.
Ketika pesan ini diterima, Dialog FilesInUse harus ditampilkan. |
|
Penghentian penginstalan dini. |
|
Pesan kesalahan dicatat. |
|
Pesan peringatan dicatat. |
|
Permintaan pengguna dicatat. |
|
Pesan status yang tidak ditampilkan dicatat. |
|
Permintaan untuk menentukan lokasi sumber yang valid. |
|
File yang digunakan informasi. Ketika pesan ini diterima, Dialog MsiRMFilesInUse harus ditampilkan. |
|
Ruang disk tidak cukup. |
|
Awal tindakan penginstalan baru dicatat. |
|
Rekaman data dengan tindakan penginstalan dicatat. |
|
Parameter untuk inisialisasi antarmuka pengguna dicatat. |
|
Informasi bilah Kemajuan .
Pesan ini mencakup informasi tentang unit sejauh ini dan jumlah total unit. Pesan ini hanya dikirim ke antarmuka pengguna eksternal dan tidak dicatat. Untuk informasi selengkapnya, lihat MsiProcessMessage. |
|
Jika ini bukan penginstalan yang tenang, maka UI dasar diinisialisasi.
Jika ini adalah penginstalan UI penuh, UI Lengkap belum diinisialisasi. Pesan ini hanya dikirim ke antarmuka pengguna eksternal dan tidak dicatat. |
|
Jika UI lengkap sedang digunakan, UI lengkap telah berakhir.
Jika ini bukan penginstalan yang tenang, UI dasar belum berakhir. Pesan ini hanya dikirim ke antarmuka pengguna eksternal dan tidak dicatat. |
|
Dikirim sebelum menampilkan dialog Full UI.
Pesan ini hanya dikirim ke antarmuka pengguna eksternal dan tidak dicatat. |
|
Penginstalan produk dimulai.
Pesan berisi ProductName dan ProductCode produk. |
|
Penginstalan produk berakhir.
Pesan berisi ProductName, ProductCode, dan nilai pengembalian produk. |
[in] pvContext
Penunjuk ke konteks aplikasi yang diteruskan ke fungsi panggilan balik.
Parameter ini dapat digunakan untuk pemeriksaan kesalahan.
[out, optional] ppuiPrevHandler
Mengembalikan penunjuk ke fungsi panggilan balik yang ditetapkan sebelumnya yang sesuai dengan spesifikasi INSTALLUI_HANDLER_RECORD , atau NULL jika sebelumnya tidak ada panggilan balik yang ditetapkan.
Nilai kembali
| Menampilkan kode | Deskripsi |
|---|---|
|
Fungsi berhasil diselesaikan. |
|
Nilai ini menunjukkan bahwa upaya dilakukan untuk memanggil fungsi ini dari tindakan kustom.
Fungsi ini tidak dapat dipanggil dari tindakan kustom. |
Keterangan
Fungsi ini tidak dapat dipanggil dari Tindakan Kustom.
Handler UI eksternal yang diaktifkan dengan memanggil MsiSetExternalUIRecord menerima pesan dalam format Objek Rekaman. Handler UI eksternal yang diaktifkan dengan memanggil MsiSetExternalUI menerima pesan dalam format string. UI eksternal selalu dipanggil sebelum UI internal Pemasang Windows. UI eksternal berbasis rekaman yang diaktifkan dipanggil sebelum UI eksternal berbasis string apa pun. Jika handler UI eksternal berbasis rekaman mengembalikan 0 (nol), pesan dikirim ke handler UI eksternal berbasis string yang diaktifkan. Jika handler UI eksternal mengembalikan nilai bukan nol, handler UI Pemasang Windows internal ditekan dan pesan dianggap ditangani.
Fungsi ini menyimpan antarmuka pengguna eksternal yang telah ditetapkannya. Untuk mengganti handler UI eksternal saat ini dengan handler sebelumnya, panggil fungsi dan tentukan INSTALLUI_HANDLER_RECORD sebagai parameter puiHandler dan 0 (nol) sebagai parameter dwMessageFilter .
Handler antarmuka pengguna eksternal yang diarahkan oleh parameter puiHandler tidak memiliki kontrol penuh atas antarmuka pengguna eksternal kecuali MsiSetInternalUI dipanggil dengan parameter dwUILevel diatur ke INSTALLUILEVEL_NONE. Jika MsiSetInternalUI tidak dipanggil, tingkat antarmuka pengguna internal default ke INSTALLUILEVEL_BASIC. Akibatnya, pesan apa pun yang tidak ditangani oleh handler antarmuka pengguna eksternal ditangani oleh Pemasang Windows. Awal "Bersiap untuk menginstal. . ." dialog selalu muncul bahkan jika handler antarmuka pengguna eksternal menangani semua pesan. MsiSetExternalUI hanya boleh dipanggil dari aplikasi Bootstrapping . Anda tidak dapat memanggil MsiSetExternalUI dari tindakan kustom.
Untuk menonaktifkan handler UI eksternal ini, panggil MsiSetExternalUIRecord dengan nilai NULL untuk parameter puiHandler .
Windows Installer 2.0 dan Windows Installer 3.0: Tidak didukung. Fungsi MsiSetExternalUIRecord tersedia dimulai dengan Windows Installer 3.1.
Untuk informasi selengkapnya tentang menggunakan handler eksternal berbasis rekaman, lihat Memantau Penginstalan Menggunakan MsiSetExternalUIRecord.
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 |