Menginisialisasi Aplikasi
Untuk mengaktifkan fungsionalitas alat penginstal, aplikasi harus memanggil sejumlah fungsi saat menginisialisasi. Untuk informasi selengkapnya, lihat Mekanisme Penginstalan. Langkah-langkah berikut menjelaskan cara menggunakan alat penginstal untuk menginisialisasi aplikasi:
Untuk menginisialisasi aplikasi
Panggil fungsi MsiGetProductCode sehingga aplikasi dapat mengidentifikasi dirinya ke alat penginstal.
Kode produk adalah parameter yang diperlukan untuk banyak fungsi alat penginstal.
Panggil fungsi MsiGetUserInfo untuk mengumpulkan informasi pengguna saat pertama kali aplikasi dimulai.
Jika panggilan ke MsiGetUserInfo gagal, panggil fungsi MsiCollectUserInfo untuk mengumpulkan informasi pengguna.
Tampilkan antarmuka pengguna default, jika perlu, dengan memanggil fungsi MsiSetInternalUI .
Untuk menulis antarmuka pengguna Anda sendiri, daftarkan dengan alat penginstal dengan memanggil fungsi MsiSetExternalUI .
Panggil fungsi MsiEnableLog untuk mengatur tingkat pengelogan.
Sajikan pengguna dengan fitur yang tersedia dengan menghitung fitur aplikasi Anda. Anda dapat menghitung fitur dengan cara berikut:
- Mengkueri fitur demi fitur alat penginstal. Misalnya, sebelum aplikasi menggambar tombol atau item menu, aplikasi memanggil fungsi MsiQueryFeatureState sehingga alat penginstal dapat memeriksa apakah fitur tersebut tersedia.
- Hitung semua fitur yang tersedia sekaligus dengan memanggil fungsi MsiEnumFeatures . Untuk menggunakan fungsi ini, aplikasi harus memanggil MsiEnumFeatures berulang kali saat menaikkan indeks.
Dapatkan informasi terperinci tentang penginstalan saat ini dengan memanggil fungsi enumerasi berikut berulang kali, menambahkan variabel indeks untuk setiap panggilan:
- Panggil fungsi MsiEnumProducts untuk menghitung produk yang terdaftar di alat penginstal.
- Panggil fungsi MsiEnumComponents untuk menghitung komponen.
- Panggil fungsi MsiEnumComponentQualifiers untuk menghitung kualifikasi komponen.
- Panggil fungsi MsiEnumClients untuk menghitung produk untuk komponen tertentu.
Jika nilai yang dikembalikan pada fungsi enumerasi ERROR_SUCCESS, masih ada lebih banyak item yang akan dijumlahkan dan fungsi harus dipanggil lagi dengan variabel indeks yang dinaikkan. Jika nilai yang dikembalikan ERROR_NO_MORE_ITEMS, maka semua item telah dijumlahkan, dan fungsi tidak boleh dipanggil lagi.