Fungsi Database

Materi ini ditujukan untuk pengembang yang menulis program penyiapan mereka sendiri dan pengembang yang ingin mempelajari lebih lanjut tentang tabel database penginstal. Untuk informasi umum tentang alat penginstal, lihat Tentang Penginstal Windows.

Anda dapat menggunakan fungsi akses alat penginstal untuk mengakses database dan proses penginstalan. Fungsi-fungsi ini hanya boleh digunakan oleh tindakan penginstalan kustom dan alat penulisan. Beberapa fungsi akses alat penginstal memerlukan string kueri SQL untuk mengkueri database. Kueri harus mematuhi sintaks SQL penginstal.

Topik ini mencantumkan fungsi akses database penginstal menurut kategori.

Fungsi Akses Database Umum

Fungsi	Deskripsi
MsiDatabaseCommit	Menerapkan perubahan pada database.
MsiDatabaseGetPrimaryKeys	Mengembalikan nama semua kolom kunci utama.
MsiDatabaseIsTablePersistent	Mengembalikan enumerasi yang menjelaskan status tabel.
MsiDatabaseOpenView	Menyiapkan kueri database dan membuat objek tampilan.
MsiGetActiveDatabase	Mengembalikan database aktif untuk penginstalan.
MsiViewGetColumnInfo	Mengembalikan nama atau definisi kolom.
MsiOpenDatabase	Membuka file database untuk akses data.
MsiViewClose	Merilis tataan hasil untuk tampilan yang dijalankan.
MsiViewExecute	Menjalankan kueri tampilan dan menyediakan parameter yang diperlukan.
MsiViewFetch	Mengambil rekaman berurutan berikutnya dari tampilan.
MsiViewGetError	Mengembalikan kesalahan yang terjadi dalam fungsi MsiViewModify .
MsiViewModify	Updates rekaman yang diambil.

 

Fungsi Manajemen Database

Fungsi	Deskripsi
MsiCreateTransformSummaryInfo	Membuat informasi ringkasan untuk transformasi yang sudah ada.
MsiDatabaseApplyTransform	Menerapkan transformasi ke database.
MsiDatabaseExport	Mengekspor tabel dari database terbuka ke file arsip teks.
MsiDatabaseGenerateTransform	Menghasilkan file transformasi perbedaan antara dua database.
MsiDatabaseImport	Mengimpor tabel arsip teks penginstal ke dalam database terbuka.
MsiDatabaseMerge	Menggabungkan dua database bersama-sama.
MsiGetDatabaseState	Mengembalikan status database.

 

Fungsi Pemrosesan Rekaman

Fungsi	Deskripsi
MsiCreateRecord	Membuat objek rekaman baru dengan jumlah bidang yang ditentukan.
MsiFormatRecord	Memformat data bidang rekaman dan properti menggunakan string format.
MsiRecordClearData	Mengatur semua bidang dalam rekaman ke null.
MsiRecordDataSize	Mengembalikan panjang bidang rekaman.
MsiRecordGetFieldCount	Mengembalikan jumlah bidang dalam rekaman.
MsiRecordGetInteger	Mengembalikan nilai bilangan bulat dari bidang rekaman.
MsiRecordGetString	Mengembalikan nilai string dari bidang rekaman.
MsiRecordIsNull	Melaporkan apakah bidang rekaman null.
MsiRecordReadStream	Membaca byte dari bidang aliran rekaman ke dalam buffer.
MsiRecordSetInteger	Mengatur bidang rekaman ke bidang bilangan bulat.
MsiRecordSetStream	Mengatur bidang aliran rekaman dari file.
MsiRecordSetString	Menyalin string ke dalam bidang yang ditunjuk.

 

Fungsi Properti Informasi Ringkasan

Fungsi	Deskripsi
MsiGetSummaryInformation	Mendapatkan handel untuk meringkas aliran informasi database penginstal.
MsiSummaryInfoGetProperty	Mendapatkan satu properti dari informasi ringkasan.
MsiSummaryInfoGetPropertyCount	Mengembalikan jumlah properti dalam aliran informasi ringkasan.
MsiSummaryInfoPersist	Menulis informasi ringkasan yang diubah kembali ke aliran informasi ringkasan.
MsiSummaryInfoSetProperty	Mengatur properti informasi ringkasan tunggal.

 

Fungsi Akses Status Alat Penginstal

Fungsi	Deskripsi
MsiGetLanguage	Mengembalikan bahasa numerik penginstalan saat ini.
MsiGetLastErrorRecord	Mengembalikan rekaman kesalahan yang terakhir dikembalikan untuk proses panggilan.
MsiGetMode	Mengembalikan salah satu status penginstalan internal Boolean.
MsiGetProperty	Mendapatkan nilai properti alat penginstal.
MsiSetProperty	Mengatur nilai properti penginstalan.
MsiSetMode	Mengatur status Boolean mesin internal.

 

Fungsi Tindakan Alat Penginstal

Fungsi	Deskripsi
MsiDoAction	Menjalankan tindakan bawaan, tindakan kustom, atau tindakan wizard antarmuka pengguna.
MsiEvaluateCondition	Mengevaluasi ekspresi kondisional yang berisi nama dan nilai properti.
MsiProcessMessage	Mengirim rekaman kesalahan ke alat penginstal untuk diproses.
MsiSequence	Menjalankan urutan tindakan.

 

Fungsi Lokasi Alat Penginstal

Fungsi	Deskripsi
MsiGetSourcePath	Mengembalikan jalur sumber lengkap untuk folder dalam tabel Direktori.
MsiGetTargetPath	Mengembalikan jalur target lengkap untuk folder dalam tabel Direktori.
MsiSetTargetPath	Mengatur jalur target lengkap untuk folder dalam tabel Direktori.

 

Fungsi Pemilihan Alat Penginstal

Fungsi	Deskripsi
MsiEnumComponentCosts	Menghitung ruang disk per drive yang diperlukan untuk menginstal komponen.
MsiGetComponentState	Mendapatkan status komponen.
MsiGetFeatureCost	Mengembalikan ruang disk yang diperlukan oleh fitur.
MsiGetFeatureState	Mendapatkan status fitur.
MsiGetFeatureValidStates	Mengembalikan status penginstalan yang valid.
MsiSetComponentState	Mengatur komponen ke status yang ditentukan.
MsiSetFeatureAttributes	Memodifikasi atribut default fitur pada durasi.
MsiSetFeatureState	Mengatur fitur ke status tertentu.
MsiSetInstallLevel	Mengatur tingkat penginstalan penginstalan produk lengkap.
MsiVerifyDiskSpace	Memeriksa ruang disk yang memadai.

 

Fungsi Antarmuka Pengguna

Fungsi	Deskripsi
MsiEnableUIPreview	Mengaktifkan mode pratinjau antarmuka pengguna.
MsiPreviewBillboard	Menampilkan billboard dengan kontrol host dalam kotak dialog yang ditampilkan.
MsiPreviewDialog	Menampilkan kotak dialog sebagai tanpa mode dan tidak aktif.

 

Semua fungsi mendukung panggilan ANSI dan Unicode. Untuk menggunakan fungsi-fungsi ini, sertakan MsiQuery.h dan tautkan dengan Msi.lib.

Fungsi Penginstalan

Selain fungsi akses database yang tercantum di atas, Anda membuat paket penginstalan untuk aplikasi dengan menggunakan fungsi alat penginstal yang tercantum di bagian Referensi Fungsi Alat Penginstal .