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 |