Properti Session.FeatureValidStates

  • Artikel

Properti FeatureValidStates dari objek Sesi mengembalikan bilangan bulat yang mewakili bendera bit dengan setiap bit yang relevan mewakili status penginstalan yang valid untuk fitur yang ditentukan.

Properti ini bersifat hanya baca.

Sintaks

propVal = Session.FeatureValidStates

Nilai properti

Nama string yang diperlukan dari item fitur yang status penginstalannya valid akan diambil.

Keterangan

Nilai yang dikembalikan terdiri dari bendera bit sebagai berikut. Bit 0: jika diatur, Lokal adalah status yang valid. Bit 1: jika diatur, Sumber adalah status yang valid.

Properti FeatureValidStates hanya berhasil setelah alat penginstal memanggil tindakan CostInitialize dan CostFinalize .

FeatureValidStates menentukan validitas status dengan mengkueri semua komponen yang ditautkan ke fitur yang ditentukan tanpa mempertimbangkan status komponen apa pun yang diinstal saat ini.

Kemungkinan status yang valid untuk fitur ditentukan sebagai berikut:

  • Jika fitur tidak berisi komponen, baik INSTALLSTATE_LOCAL maupun INSTALLSTATE_SOURCE adalah status yang valid untuk fitur tersebut.
  • Jika setidaknya satu komponen fitur memiliki atribut msidbComponentAttributesLocalOnly atau msidbComponentAttributesOptional, INSTALLSTATE_LOCAL adalah status yang valid untuk fitur tersebut.
  • Jika setidaknya satu komponen fitur memiliki atribut msidbComponentAttributesSourceOnly atau msidbComponentAttributesOptional, INSTALLSTATE_SOURCE adalah status yang valid untuk fitur tersebut.
  • Jika file komponen milik fitur di-patch atau dari sumber terkompresi, maka INSTALLSTATE_SOURCE tidak disertakan sebagai status yang valid untuk fitur tersebut.
  • INSTALLSTATE_ADVERTISE bukan status yang valid jika fitur melarang iklan (msidbFeatureAttributesDisallowAdvertise) atau fitur tersebut memerlukan dukungan platform untuk iklan (msidbFeatureAttributesNoUnsupportedAdvertise) dan platform tidak mendukungnya.
  • INSTALLSTATE_ABSENT adalah status yang valid untuk fitur jika atributnya tidak menyertakan msidbFeatureAttributesUIDisallowAbsent.
  • Status yang valid untuk fitur anak yang ditandai untuk mengikuti fitur induk (msidbFeatureAttributesFollowParent) didasarkan pada tindakan fitur induk atau status terinstal.

Jika properti gagal, Anda dapat memperoleh informasi kesalahan yang diperluas dengan menggunakan metode LastErrorRecord .

Persyaratan

Persyaratan Nilai
Versi
 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
DLL
Msi.dll
IID
 IID_ISession didefinisikan sebagai 000C109E-0000-0000-C000-000000000046