Session.FeatureValidStates-Eigenschaft

Die FeatureValidStates-Eigenschaft des Session-Objekts gibt eine ganze Zahl zurück, die ein Bitflag darstellt. Hierbei repräsentiert jedes relevante Bit einen gültigen Installationszustand für das angegebene Feature.

Diese Eigenschaft ist schreibgeschützt.

Syntax

propVal = Session.FeatureValidStates

Eigenschaftswert

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

Bemerkungen

Der Rückgabewert besteht aus Bitflags, siehe unten. Bit 0: Sofern festgelegt, ist „Local“ ein gültiger Zustand. Bit 1: Sofern festgelegt, ist „Source“ ein gültiger Zustand.

Die Eigenschaft FeatureValidStates ist erst erfolgreich, nachdem der Installer die Aktionen CostInitialize und CostFinalize aufgerufen hat.

FeatureValidStates ermittelt die Gültigkeit des Zustands, indem alle Komponenten abgefragt werden, die mit dem angegebenen Feature verknüpft sind. Hierbei wird der aktuelle Installationszustand der Komponenten nicht berücksichtigt.

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

• Wenn das Feature keine Komponenten umfasst, sind sowohl INSTALLSTATE_LOCAL als auch INSTALLSTATE_SOURCE gültige Zustände für das Feature.
• Wenn mindestens eine Komponente des Features das Attribut „msidbComponentAttributesLocalOnly“ oder „msidbComponentAttributesOptional“ aufweist, ist INSTALLSTATE_LOCAL ein gültiger Zustand für das Feature.
• Wenn mindestens eine Komponente des Features das Attribut „msidbComponentAttributesSourceOnly“ oder „msidbComponentAttributesOptional“ aufweist, ist INSTALLSTATE_SOURCE ein gültiger Zustand für das Feature.
• Wenn eine der Komponentendateien gepatcht ist oder aus einer komprimierten Quelle stammt, ist INSTALLSTATE_SOURCE kein gültiger Zustand für das Feature.
• INSTALLSTATE_ADVERTISE ist kein gültiger Zustand, wenn das Feature keine Ankündigungen zulässt (msidbFeatureAttributesDisallowAdvertise) oder das Feature Plattformunterstützung für Ankündigungen benötigt (msidbFeatureAttributesNoUnsupportedAdvertise) und die Plattform dies nicht unterstützt.
• INSTALLSTATE_ABSENT ist ein gültiger Zustand für das Feature, wenn seine Attribute nicht „msidbFeatureAttributesUIDisallowAbsent“ enthalten.
• Gültige Zustände für untergeordnete Features, die an das übergeordnete Feature gebunden sind (msidbFeatureAttributesFollowParent), basieren auf der Aktion oder dem Installationszustand des übergeordneten Features.

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

Anforderungen

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