Fungsi MsiDatabaseImportA (msiquery.h)
Fungsi MsiDatabaseImport mengimpor file arsip teks penginstal ke dalam tabel database terbuka.
Sintaks
UINT MsiDatabaseImportA(
[in] MSIHANDLE hDatabase,
[in] LPCSTR szFolderPath,
[in] LPCSTR szFileName
);
Parameter
[in] hDatabase
Tangani ke database yang diperoleh dari MsiOpenDatabase.
[in] szFolderPath
Menentukan jalur ke folder yang berisi file arsip.
[in] szFileName
Menentukan nama file yang akan diimpor.
Menampilkan nilai
Fungsi MsiDatabaseImport mengembalikan salah satu nilai berikut:
Keterangan
Saat Anda menggunakan fungsi MsiDatabaseImport untuk mengimpor tabel arsip teks bernama _SummaryInformation ke dalam database penginstal, Anda menulis aliran "05SummaryInformation". Aliran ini berisi properti standar yang dapat dilihat menggunakan Windows Explorer dan ditentukan oleh COM. Baris tabel ditulis ke aliran properti sebagai pasangan nomor ID properti dan nilai data terkait. Lihat Ringkasan Kumpulan Properti Aliran Informasi. Tanggal dan waktu dalam _SummaryInformation dalam format: YYYY/MM/DD hh::mm::ss. Misalnya, 1999/03/22 15:25:45. Jika tabel berisi aliran biner, nama aliran berada di bidang data, dan aliran aktual diambil dari file nama tersebut dalam subfolder dengan nama yang sama dengan tabel.
File arsip teks yang diekspor dari database oleh MsiDatabaseExport dimaksudkan untuk digunakan dengan sistem kontrol versi, dan tidak dimaksudkan untuk digunakan sebagai sarana pengeditan data. Gunakan fungsi dan alat API database yang dirancang untuk tujuan tersebut. Perhatikan bahwa karakter kontrol dalam file arsip teks diterjemahkan untuk menghindari konflik dengan pemisah file. Jika file arsip teks berisi data non-ASCII, file tersebut dicap dengan halaman kode data, dan hanya dapat diimpor ke database halaman kode yang tepat, atau ke database netral. Database netral diatur ke halaman kode file yang diimpor. Database dapat diatur tanpa syarat ke halaman kode tertentu dengan mengimpor tabel semu bernama: _ForceCodepage. Format file tersebut adalah: Dua baris kosong, diikuti dengan baris yang berisi halaman kode numerik, pemisah tab, dan string yang tepat: _ForceCodepage
Fungsi ini tidak dapat dipanggil dari tindakan kustom. Panggilan ke fungsi ini dari tindakan kustom menyebabkan fungsi gagal.
Jika fungsi gagal, Anda dapat memperoleh informasi kesalahan yang diperluas dengan menggunakan MsiGetLastErrorRecord.
Catatan
Header msiquery.h mendefinisikan MsiDatabaseImport 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
| 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. Pemasang Windows pada Windows Server 2003 atau Windows XP |
| Target Platform | Windows |
| Header | msiquery.h |
| Pustaka | Msi.lib |
| DLL | Msi.dll |