Fungsi MsiSetFeatureAttributesA (msiquery.h)

Artikel
03/15/2023

Fungsi MsiSetFeatureAttributes dapat memodifikasi atribut default fitur saat runtime. Perhatikan bahwa atribut default fitur ditulis di kolom Atribut dari tabel Fitur.

Sintaks

UINT MsiSetFeatureAttributesA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szFeature,
  [in] DWORD     dwAttributes
);

Parameter

[in] hInstall

Tangani penginstalan yang disediakan untuk tindakan kustom DLL atau diperoleh melalui MsiOpenPackage, MsiOpenPackageEx, atau MsiOpenProduct.

[in] szFeature

Menentukan nama fitur dalam produk.

[in] dwAttributes

Atribut fitur yang ditentukan pada durasi sebagai sekumpulan bendera bit:

Terus-menerus	Makna
INSTALLFEATUREATTRIBUTE_FAVORLOCAL 1	Memodifikasi atribut fitur default ke msidbFeatureAttributesFavorLocal pada durasi. Lihat Kolom atribut tabel Fitur untuk deskripsi.
INSTALLFEATUREATTRIBUTE_FAVORSOURCE 2	Memodifikasi atribut fitur default ke msidbFeatureAttributesFavorSource pada durasi. Lihat Kolom atribut tabel Fitur untuk deskripsi.
INSTALLFEATUREATTRIBUTE_FOLLOWPARENT 4	Memodifikasi atribut fitur default ke msidbFeatureAttributesFollowParent pada durasi. Perhatikan bahwa ini bukan atribut yang valid untuk diatur untuk fitur tingkat atas. Lihat Kolom atribut tabel Fitur untuk deskripsi.
INSTALLFEATUREATTRIBUTE_FAVORADVERTISE 8	Memodifikasi atribut fitur default ke msidbFeatureAttributesFavorAdvertise pada durasi. Lihat Kolom atribut tabel Fitur untuk deskripsi.
INSTALLFEATUREATTRIBUTE_DISALLOWADVERTISE 16	Memodifikasi atribut fitur default ke msidbFeatureAttributesDisallowAdvertise pada durasi. Lihat Kolom atribut tabel Fitur untuk deskripsi.
INSTALLFEATUREATTRIBUTE_NOUNSUPPORTEDADVERTISE 32	Memodifikasi atribut fitur default ke msidbFeatureAttributesNoUnsupportedAdvertise pada durasi. Lihat Kolom atribut tabel Fitur untuk deskripsi.

Mengembalikan nilai

Fungsi ini mengembalikan UINT.

Keterangan

MsiSetFeatureAttributes harus dipanggil setelah tindakan CostInitialize dan sebelum tindakan CostFinalize. Fungsi mengembalikan ERROR_FUNCTION_FAILED jika dipanggil pada waktu lain.

Bendera INSTALLFEATUREATTRIBUTE_FAVORLOCAL, INSTALLFEATUREATTRIBUTE_FAVORSOURCE, dan INSTALLFEATUREATTRIBUTE_FOLLOWPARENT saling eksklusif. Hanya salah satu bit ini yang dapat diatur untuk fitur apa pun. Jika lebih dari salah satu bendera ini diatur, perilaku fitur tersebut tidak terdefinisi.

Lihat Memanggil Fungsi Database Dari Program.

Catatan

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

Bagikan melalui