Fungsi MsiGetSummaryInformationA (msiquery.h)
Fungsi MsiGetSummaryInformation mendapatkan handel ke aliran _SummaryInformation untuk database penginstal. Fungsi ini mengembalikan handel yang harus ditutup menggunakan MsiCloseHandle.
Sintaks
UINT MsiGetSummaryInformationA(
[in] MSIHANDLE hDatabase,
[in] LPCSTR szDatabasePath,
[in] UINT uiUpdateCount,
[out] MSIHANDLE *phSummaryInfo
);
Parameter
[in] hDatabase
Menangani ke database.
[in] szDatabasePath
Menentukan jalur ke database.
[in] uiUpdateCount
Menentukan jumlah maksimum nilai yang diperbarui.
[out] phSummaryInfo
Arahkan kursor ke lokasi untuk menerima penanganan informasi ringkasan.
Nilai kembali
Fungsi MsiGetSummaryInformation mengembalikan nilai berikut:
Keterangan
Jika database yang ditentukan oleh fungsi MsiGetSummaryInformation tidak terbuka, Anda harus menentukan 0 untuk hDatabase dan menentukan jalur ke database di szDatabasePath. Jika database terbuka, Anda harus mengatur szDatabasePath ke 0.
Jika nilai uiUpdateCount yang lebih besar dari 0 digunakan untuk membuka aliran informasi ringkasan yang ada, MsiSummaryInfoPersist harus dipanggil sebelum menutup handel phSummaryInfo . Gagal melakukan ini akan kehilangan informasi aliran yang ada.
Untuk melihat informasi ringkasan patch menggunakan MsiGetSummaryInformation, atur szDatabasePath ke jalur ke patch. Secara bergantian, Anda dapat membuat handel ke patch menggunakan MsiOpenDatabase lalu meneruskan handel tersebut ke MsiGetSummaryInformation sebagai parameter hDatabase .
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 MsiGetSummaryInformation 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
| 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 |