Fungsi MsiDatabaseOpenViewA (msiquery.h)
Fungsi MsiDatabaseOpenView menyiapkan kueri database dan membuat objek tampilan. Fungsi ini mengembalikan handel yang harus ditutup menggunakan MsiCloseHandle.
Sintaks
UINT MsiDatabaseOpenViewA(
[in] MSIHANDLE hDatabase,
[in] LPCSTR szQuery,
[out] MSIHANDLE *phView
);
Parameter
[in] hDatabase
Tangani ke database yang ingin Anda buka objek tampilannya. Anda bisa mendapatkan handel seperti yang dijelaskan dalam Mendapatkan Penanganan Database.
[in] szQuery
Menentukan string kueri SQL untuk mengkueri database. Untuk sintaks yang benar, lihat Sintaks SQL.
[out] phView
Penunjuk ke handel untuk tampilan yang dikembalikan.
Mengembalikan nilai
Fungsi MsiDatabaseOpenView mengembalikan salah satu nilai berikut:
ERROR_SUCCESS jika berhasil, dan tampilan menangani titik parameter phView [out] diatur.
ERROR_INVALID_HANDLE, ERROR_INVALID_HANDLE_STATE, ERROR_BAD_QUERY_SYNTAX, atau ERROR_GEN_FAILURE jika gagal, dan mengatur catatan kesalahan, dapat diakses melalui MsiGetLastErrorRecord.
Keterangan
Fungsi MsiDatabaseOpenView membuka objek tampilan untuk database. Anda harus membuka objek tampilan untuk database sebelum melakukan eksekusi atau pengambilan apa pun.
Jika terjadi kesalahan, Anda dapat memanggil MsiGetLastErrorRecord untuk informasi selengkapnya.
Perhatikan bahwa disarankan untuk menggunakan variabel jenis PMSIHANDLE karena alat penginstal menutup objek PMSIHANDLE saat keluar dari cakupan, sedangkan Anda harus menutup objek MSIHANDLE dengan memanggil MsiCloseHandle. Untuk informasi selengkapnya lihat Menggunakan PMSIHANDLE alih-alih bagian HANDLE di Praktik Terbaik Penginstal Windows.
Jika fungsi gagal, Anda dapat memperoleh informasi kesalahan yang diperluas dengan menggunakan MsiGetLastErrorRecord.
Catatan
Header msiquery.h mendefinisikan MsiDatabaseOpenView sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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 | msiquery.h |
| Pustaka | Msi.lib |
| DLL | Msi.dll |