Bagikan melalui

INSTALLUI_HANDLERA fungsi panggilan balik (msi.h)

  • Artikel

Prototipe fungsi INSTALLUI_HANDLER mendefinisikan fungsi panggilan balik yang dipanggil alat penginstal untuk pemberitahuan kemajuan dan pesan kesalahan. Untuk informasi selengkapnya tentang penggunaan prototipe fungsi ini, cuplikan kode sampel tersedia di Menangani Pesan Kemajuan Menggunakan MsiSetExternalUI.

Sintaksis

INSTALLUI_HANDLERA InstalluiHandlera;

int InstalluiHandlera(
  LPVOID pvContext,
  UINT iMessageType,
  LPCSTR szMessage
)
{...}

Parameter

pvContext

Penunjuk ke konteks aplikasi yang diteruskan ke fungsi MsiSetExternalUI. 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.

Gaya kotak pesanFlag Arti
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 Batalkan.
MB_RETRYCANCEL
 Kotak pesan berisi tombol Coba Lagi dan Batalkan.
MB_YESNO
 Kotak pesan berisi tombol Ya dan Tidak ada.
MB_YESNOCANCEL
 Kotak pesan berisi tombol Ya, Tidak, dan Batalkan.
 
Kotak pesan IconTypesFlag Arti
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 Arti
MB_DEFBUTTON1
 Tombol pertama adalah tombol default.
MB_DEFBUTTON2
 Tombol kedua adalah tombol default.
MB_DEFBUTTON3
 Tombol ketiga adalah tombol default.
 
Pasang pesan TypeFlag Arti
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 digunakan yang harus ditutup sebelum diganti.
INSTALLMESSAGE_RESOLVESOURCE
 Permintaan untuk menentukan lokasi sumber yang valid
INSTALLMESSAGE_RMFILESINUSE
 Daftar file yang saat ini digunakan yang harus ditutup sebelum diganti. Tersedia dimulai dengan Penginstal Windows 4.0. Untuk informasi selengkapnya tentang pesan ini, lihat Menggunakan Restart Manager denganUI Eksternal .
INSTALLMESSAGE_OUTOFDISKSPACE
 Pesan ruang disk tidak cukup
INSTALLMESSAGE_ACTIONSTART
 Pesan awal tindakan. Pesan ini mencakup nama tindakan dan deskripsi.
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 wizard 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, tidak ada ikon, dan MB_DEFBUTTON1. Tidak ada jenis pesan penginstalan default; jenis pesan selalu ditentukan.

szMessage

Menentukan teks pesan.

Mengembalikan nilai

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

IDOK

 
IDCANCEL
 
IDABORT
 
IDRETRY
 
IDIGNORE
 
IDYES
 
IDNO

Komentar

Untuk informasi selengkapnya tentang mengembalikan nilai dari handler antarmuka pengguna eksternal, lihat Mengembalikan Nilai dari topik Handler Antarmuka Pengguna Eksternal.

Nota

Header msi.h mendefinisikan INSTALLUI_HANDLER sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat 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 pada Windows Server 2008 atau Windows Vista. Windows Installer pada Windows Server 2003 atau Windows XP
Platform Target Windows
Header msi.h

Lihat juga

MsiSetExternalUI