Fungsi MsiEnumFeaturesA (msi.h)
Fungsi MsiEnumFeatures menghitung fitur yang diterbitkan untuk produk tertentu. Fungsi ini mengambil satu ID fitur setiap kali dipanggil.
Sintaks
UINT MsiEnumFeaturesA(
[in] LPCSTR szProduct,
[in] DWORD iFeatureIndex,
[out] LPSTR lpFeatureBuf,
[out] LPSTR lpParentBuf
);
Parameter
[in] szProduct
String yang dihentikan null yang menentukan kode produk produk yang fiturnya akan dijumlahkan.
[in] iFeatureIndex
Menentukan indeks fitur yang akan diambil. Parameter ini harus nol untuk panggilan pertama ke fungsi MsiEnumFeatures dan kemudian dinaikkan untuk panggilan berikutnya. Karena fitur tidak diurutkan, fitur baru apa pun memiliki indeks arbitrer. Ini berarti bahwa fungsi dapat mengembalikan fitur dalam urutan apa pun.
[out] lpFeatureBuf
Penunjuk ke buffer yang menerima ID fitur. Ukuran buffer harus menahan nilai string dengan panjang MAX_FEATURE_CHARS+1. Fungsi mengembalikan ERROR_MORE_DATA jika panjang ID fitur melebihi MAX_FEATURE_CHARS.
[out] lpParentBuf
Penunjuk ke buffer yang menerima ID fitur induk fitur. Ukuran buffer harus menahan nilai string dengan panjang MAX_FEATURE_CHARS+1. Jika panjang ID fitur fitur induk melebihi MAX_FEATURE_CHARS, hanya karakter MAX_FEATURE_CHARS pertama yang disalin ke dalam buffer.
Mengembalikan nilai
Nilai | Makna |
---|---|
|
Data konfigurasi rusak. |
|
Parameter yang tidak valid diteruskan ke fungsi. |
|
Buffer terlalu kecil untuk menyimpan data yang diminta. |
|
Tidak ada fitur untuk dikembalikan. |
|
Nilai dijumlahkan. |
|
Produk yang ditentukan tidak diketahui. |
Keterangan
Untuk menghitung fitur, aplikasi awalnya harus memanggil fungsi MsiEnumFeatures dengan parameter iFeatureIndex diatur ke nol. Aplikasi kemudian harus menaikkan parameter iFeatureIndex dan memanggil MsiEnumFeatures sampai tidak ada lagi fitur (yaitu, sampai fungsi kembali ERROR_NO_MORE_ITEMS).
Catatan
Header msi.h mendefinisikan MsiEnumFeatures 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. Pemasang Windows pada Windows Server 2003 atau Windows XP. Lihat Persyaratan Run-Time Penginstal Windows untuk informasi tentang paket layanan Windows minimum yang diperlukan oleh versi Pemasang Windows. |
Target Platform | Windows |
Header | msi.h |
Pustaka | Msi.lib |
DLL | Msi.dll |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk