INSTALLUI_HANDLERA fungsi panggilan balik (msi.h)

  • Artikel

Prototipe fungsi INSTALLUI_HANDLER menentukan 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 dalam Menangani Pesan Kemajuan Menggunakan MsiSetExternalUI.

Sintaks

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.

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 Pemasang Windows 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.

szMessage

Menentukan teks pesan.

Nilai kembali

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

IDOK

 
IDCANCEL
 
IDABORT
 
IDRETRY
 
IDIGNORE
 
IDYES
 
IDNO

Keterangan

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

Catatan

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

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

Lihat juga

MsiSetExternalUI