Fungsi MsiDatabaseOpenViewA (msiquery.h)

  • Artikel

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

Lihat juga

Fungsi Akses Database Umum