Fungsi MsiGetSummaryInformationA (msiquery.h)

  • Artikel

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

Lihat juga

Fungsi Properti Informasi Ringkasan

Kumpulan Properti Stream Informasi Ringkasan