Fungsi MsiViewExecute (msiquery.h)

Fungsi MsiViewExecute menjalankan kueri tampilan SQL dan menyediakan parameter yang diperlukan. Kueri menggunakan token tanda tanya untuk mewakili parameter seperti yang dijelaskan dalam Sintaks SQL. Nilai parameter ini diteruskan sebagai bidang terkait dari rekaman parameter.

Sintaks

UINT MsiViewExecute(
  [in] MSIHANDLE hView,
  [in] MSIHANDLE hRecord
);

Parameter

[in] hView

Tangani ke tampilan untuk menjalankan kueri.

[in] hRecord

Tangani ke rekaman yang memasok parameter. Parameter ini berisi nilai untuk mengganti token parameter dalam kueri SQL. Ini opsional, jadi hRecord bisa nol. Untuk referensi tentang sintaks, lihat Sintaks SQL.

Mengembalikan nilai

Perhatikan bahwa dalam situasi memori rendah, fungsi ini dapat meningkatkan pengecualian STATUS_NO_MEMORY.

Keterangan

Fungsi MsiViewExecute harus dipanggil sebelum panggilan apa pun ke MsiViewFetch.

Jika kueri SQL menentukan nilai dengan penanda parameter (?), rekaman harus disediakan yang berisi semua nilai penggantian dalam urutan yang tepat dan jenis data yang kompatibel. Saat digunakan dengan KUERI INSERT dan UPDATE, semua nilai parameter harus mendahului semua nilai yang tidak diparameterkan.

Misalnya, kueri ini valid.

UPDATE {table-list} SET {column}= ? , {column}= {constant}

INSERT INTO {table} ({column-list}) VALUES (?, {constant-list})

Namun kueri ini tidak valid.

UPDATE {table-list} SET {column}= {constant}, {column}=?

INSERT INTO {table} ({column-list}) VALUES ({constant-list}, ? )

Jika fungsi gagal, Anda dapat memperoleh informasi kesalahan yang diperluas dengan menggunakan MsiGetLastErrorRecord.

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