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 .