Share via

INSTALLUI_HANDLER_RECORD fungsi panggilan balik (msi.h)

  • Artikel

Prototipe fungsi INSTALLUI_HANDLER_RECORD mendefinisikan fungsi panggilan balik yang dipanggil alat penginstal untuk pemberitahuan kemajuan dan pesan kesalahan. Panggil fungsi MsiSetExternalUIRecord untuk mengaktifkan handler antarmuka pengguna eksternal (UI) berbasis rekaman.

Windows Installer 3.0 dan Windows Installer 2.0: Tidak didukung. Tersedia dimulai dengan Penginstal Windows versi 3.1 dan yang lebih baru.

Sintaks

INSTALLUI_HANDLER_RECORD InstalluiHandlerRecord;

int InstalluiHandlerRecord(
  LPVOID pvContext,
  UINT iMessageType,
  MSIHANDLE hRecord
)
{...}

Parameter

pvContext

Penunjuk ke konteks aplikasi yang diteruskan ke fungsi MsiSetExternalUIRecord . Parameter ini dapat digunakan untuk pemeriksaan kesalahan.

iMessageType

Menentukan kombinasi satu gaya kotak pesan, satu tipe ikon kotak pesan, satu tombol default, dan satu jenis pesan penginstalan. Parameter ini harus salah satu dari yang berikut ini.

Kotak pesan StylesFlag Makna
MB_ABORTRETRYIGNORE
 Kotak pesan berisi tombol Batalkan, Coba Lagi, dan Abaikan .
MB_OK
 Kotak pesan berisi tombol OK . Ini adalah default.
MB_OKCANCEL
 Kotak pesan berisi tombol OK dan Batal .
MB_RETRYCANCEL
 Kotak pesan berisi tombol Coba Lagi dan Batalkan .
MB_YESNO
 Kotak pesan berisi tombol Ya dan Tidak .
MB_YESNOCANCEL
 Kotak pesan berisi tombol Ya, Tidak, dan Batal .
 
Kotak pesan IconTypesFlag Makna
MB_ICONEXCLAMATION, MB_ICONWARNING
 Tanda seru muncul di kotak pesan.
MB_ICONINFORMATION, MB_ICONASTERISK
 Tanda informasi muncul di kotak pesan.
MB_ICONQUESTION
 Tanda tanya muncul di kotak pesan.
MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND
 Tanda berhenti muncul di kotak pesan.
 
Tombol DefaultFlag Makna
MB_DEFBUTTON1
 Tombol pertama adalah tombol default.
MB_DEFBUTTON2
 Tombol kedua adalah tombol default.
MB_DEFBUTTON3
 Tombol ketiga adalah tombol default.
 
Instal pesan TypeFlag Makna
INSTALLMESSAGE_FATALEXIT
 Penghentian dini
INSTALLMESSAGE_ERROR
 Pesan kesalahan yang diformat
INSTALLMESSAGE_WARNING
 Pesan peringatan yang diformat
INSTALLMESSAGE_USER
 Pesan permintaan pengguna.
INSTALLMESSAGE_INFO
 Pesan informatif untuk log
INSTALLMESSAGE_FILESINUSE
 Daftar file yang saat ini sedang digunakan yang harus ditutup sebelum diganti
INSTALLMESSAGE_RESOLVESOURCE
 Permintaan untuk menentukan lokasi sumber yang valid
INSTALLMESSAGE_RMFILESINUSE
 Daftar file yang saat ini sedang digunakan yang harus ditutup sebelum diganti. Tersedia dimulai dengan Penginstal Windows versi 4.0. Untuk informasi selengkapnya tentang pesan ini lihat Menggunakan Restart Manager dengan UI Eksternal.
INSTALLMESSAGE_OUTOFDISKSPACE
 Pesan ruang disk tidak cukup
INSTALLMESSAGE_ACTIONSTART
 Pesan awal tindakan. Pesan ini mencakup nama dan deskripsi tindakan.
INSTALLMESSAGE_ACTIONDATA
 Data terformat yang terkait dengan item tindakan individual.
INSTALLMESSAGE_PROGRESS
 Informasi pengukur kemajuan. Pesan ini mencakup informasi tentang unit sejauh ini dan jumlah total unit.
INSTALLMESSAGE_COMMONDATA
 Informasi dialog yang diformat untuk antarmuka pengguna.
INSTALLMESSAGE_INITIALIZE
 Dikirim sebelum inisialisasi UI, tidak ada data string
INSTALLMESSAGE_TERMINATE
 Dikirim setelah penghentian UI, tidak ada data string
INSTALLMESSAGE_SHOWDIALOG
 Dikirim sebelum menampilkan dialog atau panduan yang ditulis
INSTALLMESSAGE_INSTALLSTART
 Dikirim sebelum penginstalan produk.
INSTALLMESSAGE_INSTALLEND
 Dikirim setelah penginstalan produk.
 
 

Default berikut harus digunakan jika salah satu pesan sebelumnya hilang: MB_OK, tanpa ikon, dan MB_DEFBUTTON1. Tidak ada jenis pesan penginstalan default; jenis pesan selalu ditentukan.

hRecord

Menentukan handel ke objek rekaman. Untuk informasi tentang objek rekaman, lihat Fungsi Pemrosesan Rekaman.

Mengembalikan nilai

Nilai pengembalian berikut memetakan ke tombol yang ditentukan oleh gaya kotak pesan:

IDOK

 
IDCANCEL
 
IDABORT
 
IDRETRY
 
IDIGNORE
 
IDYES
 
IDNO

Keterangan

Jenis handler UI eksternal ini harus digunakan ketika diketahui jenis kesalahan atau pesan apa yang diminati pemanggil, dan ingin menghindari overhead penguraian pesan string yang dikirim ke handler UI eksternal dari jenis INSTALLUI_HANDLER, tetapi mengambil data yang menarik dari bidang hRecord.

Untuk informasi selengkapnya tentang mengembalikan nilai dari handler antarmuka pengguna eksternal, lihat topik Mengembalikan Nilai dari Handler Antarmuka Pengguna Eksternal . Objek hRecord yang dikirim ke handler UI eksternal berbasis rekaman dimiliki oleh Pemasang Windows dan hanya berlaku untuk masa pakai panggilan balik. Panggilan balik harus mengekstrak dari rekaman data apa pun yang dibutuhkan dan tidak boleh menutup handel itu.

Setiap upaya oleh handler UI eksternal berbasis rekaman untuk mengubah data dalam objek hRecord akan diabaikan oleh Pemasang Windows.

Untuk informasi selengkapnya tentang menggunakan handler eksternal berbasis rekaman, lihat Memantau Penginstalan Menggunakan MsiSetExternalUIRecord.

Persyaratan

Persyaratan Nilai
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. Windows Installer 3.1 di Windows Server 2003 atau Windows XP.
Target Platform Windows
Header msi.h

Lihat juga

MsiSetExternalUI

Tidak Didukung di Windows Installer 3.0 dan yang lebih lama