Fungsi MsiEnumProductsW (msi.h)

Artikel
11/20/2024

Fungsi MsiEnumProducts menghitung melalui semua produk yang saat ini diiklankan atau diinstal. Produk yang diinstal dalam konteks penginstalan per pengguna dan per mesin dan iklan dijumlahkan.

Sintaksis

UINT MsiEnumProductsW(
  [in]  DWORD  iProductIndex,
  [out] LPWSTR lpProductBuf
);

Parameter

[in] iProductIndex

Menentukan indeks produk yang akan diambil. Parameter ini harus nol untuk panggilan pertama ke fungsi MsiEnumProducts lalu ditingkatkan untuk panggilan berikutnya. Karena produk tidak dipesan, produk baru apa pun memiliki indeks arbitrer. Ini berarti bahwa fungsi dapat mengembalikan produk dalam urutan apa pun.

[out] lpProductBuf

Penunjuk ke buffer yang menerima kode produk. Panjang buffer ini harus 39 karakter. 38 karakter pertama adalah untuk GUID, dan karakter terakhir adalah untuk karakter null yang mengakhiri.

Mengembalikan nilai

Nilai	Arti
ERROR_BAD_CONFIGURATION	Data konfigurasi rusak.
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi.
ERROR_NO_MORE_ITEMS	Tidak ada produk untuk dikembalikan.
ERROR_NOT_ENOUGH_MEMORY	Sistem tidak memiliki cukup memori untuk menyelesaikan operasi. Tersedia dengan Windows Server 2003.
ERROR_SUCCESS	Nilai dijumlahkan.

Komentar

Untuk menghitung produk, aplikasi awalnya harus memanggil fungsi MsiEnumProducts dengan parameter iProductIndex diatur ke nol. Aplikasi kemudian harus meningkatkan parameter iProductIndex dan memanggil MsiEnumProducts sampai tidak ada lagi produk (sampai fungsi kembali ERROR_NO_MORE_ITEMS).

Saat melakukan beberapa panggilan ke MsiEnumProducts untuk menghitung semua produk, setiap panggilan harus dilakukan dari utas yang sama.

Nota

Header msi.h mendefinisikan MsiEnumProducts sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosem 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

Syarat	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 pada Windows Server 2008 atau Windows Vista. Windows Installer pada Windows Server 2003 atau Windows XP. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Penginstal Windows.
Platform Target	Windows
Header	msi.h
Pustaka	Msi.lib
DLL	Msi.dll

Lihat juga

Menentukan konteks penginstalan

Fungsi Status Sistem

Bagikan melalui