Fungsi MsiEnumFeaturesW (msi.h)

Artikel
11/20/2024

Fungsi MsiEnumFeatures menghitung fitur yang diterbitkan untuk produk tertentu. Fungsi ini mengambil satu ID fitur setiap kali dipanggil.

Sintaksis

UINT MsiEnumFeaturesW(
  [in]  LPCWSTR szProduct,
  [in]  DWORD   iFeatureIndex,
  [out] LPWSTR  lpFeatureBuf,
  [out] LPWSTR  lpParentBuf
);

Parameter

[in] szProduct

String yang dihentikan dengan 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 lalu ditahapkan 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 menyimpan nilai string 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 menyimpan nilai string 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	Arti
ERROR_BAD_CONFIGURATION	Data konfigurasi rusak.
ERROR_INVALID_PARAMETER	Parameter yang tidak valid diteruskan ke fungsi.
ERROR_MORE_DATA	Buffer terlalu kecil untuk menyimpan data yang diminta.
ERROR_NO_MORE_ITEMS	Tidak ada fitur untuk dikembalikan.
ERROR_SUCCESS	Nilai dijumlahkan.
ERROR_UNKNOWN_PRODUCT	Produk yang ditentukan tidak diketahui.

Komentar

Untuk menghitung fitur, aplikasi awalnya harus memanggil fungsi MsiEnumFeatures dengan parameter iFeatureIndex diatur ke nol. Aplikasi kemudian harus meningkatkan parameter iFeatureIndex dan memanggil MsiEnumFeatures sampai tidak ada lagi fitur (yaitu, sampai fungsi kembali ERROR_NO_MORE_ITEMS).

Nota

Header msi.h mendefinisikan MsiEnumFeatures 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

Fungsi Status Sistem

Bagikan melalui