Session.FeatureValidStates-Eigenschaft

Die FeatureValidStates-Eigenschaft des Session-Objekts gibt eine ganze Zahl zurück, die Bitflags mit jedem relevanten Bit darstellt, das einen gültigen Installationszustand für das angegebene Feature darstellt.

Diese Eigenschaft ist schreibgeschützt.

Syntax

propVal = Session.FeatureValidStates

Eigenschaftswert

Erforderlicher Zeichenfolgenname des Featureelements, dessen gültige Installationszustände abgerufen werden sollen.

Hinweise

Der Rückgabewert besteht wie folgt aus Bitflags. Bit 0: Wenn festgelegt, ist Local ein gültiger Zustand. Bit 1: Wenn festgelegt, ist Quelle ein gültiger Zustand.

Die FeatureValidStates-Eigenschaft ist erst erfolgreich, nachdem das Installationsprogramm die Aktionen CostInitialize und CostFinalize aufgerufen hat.

FeatureValidStates bestimmt die Gültigkeit des Zustands durch Abfragen aller Komponenten, die mit dem angegebenen Feature verknüpft sind, ohne den aktuellen installierten Zustand einer Komponente zu berücksichtigen.

Die möglichen gültigen Zustände für ein Feature werden wie folgt bestimmt:

  • Wenn das Feature keine Komponenten enthält, sind SOWOHL INSTALLSTATE LOCAL als auch INSTALLSTATE SOURCE gültige _ _ Zustände für das Feature.
  • Wenn mindestens eine Komponente des Features über das Attribut msidbComponentAttributesLocalOnly oder msidbComponentAttributesOptional verfügt, ist INSTALLSTATE LOCAL ein gültiger Zustand für das _ Feature.
  • Wenn mindestens eine Komponente des Features über das Attribut msidbComponentAttributesSourceOnly oder msidbComponentAttributesOptional verfügt, ist INSTALLSTATE SOURCE ein gültiger Zustand für das _ Feature.
  • Wenn eine Datei einer Komponente, die zum Feature gehört, gepatcht oder aus einer komprimierten Quelle stammt, ist INSTALLSTATE SOURCE nicht als gültiger Zustand für das _ Feature enthalten.
  • INSTALLSTATE ADVERTISE ist kein gültiger Zustand, wenn das Feature keine Ankündigung zuordnet _ (msidbFeatureAttributesDisallowAdvertise) oder das Feature Plattformunterstützung für Ankündigungen (msidbFeatureAttributesNoUnsupportedAdvertise) erfordert und die Plattform sie nicht unterstützt.
  • INSTALLSTATE ABSENT ist ein gültiger Zustand für das Feature, wenn seine Attribute _ msidbFeatureAttributesUIDisallowAbsent nicht enthalten.
  • Gültige Zustände für untergeordnete Features, die als dem übergeordneten Feature (msidbFeatureAttributesFollowParent) folgen, basieren auf der Aktion oder dem installierten Zustand des übergeordneten Features.

Wenn die Eigenschaft fehlschlägt, können Sie erweiterte Fehlerinformationen mithilfe der LastErrorRecord-Methode abrufen.

Anforderungen

Anforderung Wert
Version
Windows Installer 5.0 auf Windows Server 2012, Windows 8, Windows Server 2008 R2 oder Windows 7. Windows Installer 4.0 oder Windows Installer 4.5 auf Windows Server 2008 oder Windows Vista. Windows Installationsprogramm auf Windows Server 2003 oder Windows XP
DLL
Msi.dll
IID
IID ISession ist als _ 000C109E-0000-0000-C000-000000000046 definiert.