Mengembalikan Pesan Kesalahan dari Tindakan Kustom
Bagian ini menjelaskan cara mengirim pesan dari tindakan kustom yang benar-benar melakukan bagian dari penginstalan dengan memanggil pustaka atau skrip tautan dinamis. Perhatikan bahwa Tindakan Kustom Tipe 19 hanya mengirim pesan kesalahan tertentu, mengembalikan kegagalan, lalu mengakhiri penginstalan. Tindakan Kustom Tipe 19 tidak melakukan bagian mana pun dari penginstalan.
Untuk mengirim pesan kesalahan dari tindakan kustom yang menggunakan pustaka tautan dinamis (DLL), minta tindakan kustom memanggil MsiProcessMessage. Perhatikan bahwa tindakan kustom yang diluncurkan oleh DoAction ControlEvent dapat mengirim pesan dengan metode Pesan tetapi tidak dapat mengirim pesan dengan MsiProcessMessage. Pada sistem yang lebih lama dari Windows Server 2003, tindakan kustom yang diluncurkan oleh DoAction ControlEvent tidak dapat mengirim pesan dengan metode MsiProcessMessage atau Message . Untuk informasi selengkapnya, lihat Mengirim Pesan ke Pemasang Windows Menggunakan MsiProcessMessage.
Untuk menampilkan pesan kesalahan dari dalam tindakan kustom menggunakan DLL
- Tindakan kustom harus memanggil MsiProcessMessage dan meneruskan parameter hInstall, eMessageType, dan hRecord. Handel ke penginstalan, Tindakan Kustom Tipe 19, dapat diberikan ke tindakan kustom seperti yang dijelaskan dalam Mengakses Sesi Penginstal Saat Ini dari Dalam Tindakan Kustom atau dari MsiOpenProduct atau MsiOpenPackage.
- Parameter eMessageType harus menentukan salah satu jenis pesan seperti yang tercantum dalam MsiProcessMessage.
- Parameter hRecord dari fungsi MsiProcessMessage tergantung pada jenis pesan. Lihat Mengirim Pesan ke Penginstal Windows Menggunakan MsiProcessMessage. Jika pesan berisi data yang diformat, masukkan pesan ke dalam tabel Kesalahan menggunakan pemformatan yang dijelaskan dalam Diformat.
Untuk mengirim pesan kesalahan dari tindakan kustom yang menggunakan Skrip, tindakan kustom dapat memanggil metode Pesan objek Sesi .
Untuk menampilkan pesan kesalahan dari dalam tindakan kustom menggunakan skrip
- Tindakan kustom harus memanggil metode Pesan objek Sesi dan meneruskan jenis parameter dan rekaman.
- Jenis parameter harus menentukan salah satu jenis pesan yang tercantum dalam metode Pesan.
- Parameter rekaman metode Pesan bergantung pada jenis pesan. Jika pesan berisi data yang diformat, masukkan pesan ke dalam tabel Kesalahan menggunakan pemformatan yang dijelaskan dalam Diformat.
Tindakan kustom menggunakan File yang Dapat Dieksekusi tidak dapat mengirim pesan dengan memanggil MsiProcessMessage atau metode Pesan karena tidak dapat menangani penginstalan.
Topik terkait