Session.FeatureValidStates (propiedad)

La propiedad FeatureValidStates del objeto Session devuelve un entero que representa marcas de bits con cada bit pertinente que representa un estado de instalación válido para la característica especificada.

Esta propiedad es de solo lectura.

Sintaxis

propVal = Session.FeatureValidStates

Valor de propiedad

Nombre de cadena requerido del elemento de característica cuyos estados de instalación válidos se van a recuperar.

Comentarios

El valor devuelto se compone de marcas de bits como se indica a continuación. Bit 0: si se establece, Local es un estado válido. Bit 1: si se establece, Source es un estado válido.

La propiedad FeatureValidStates solo se realiza correctamente después de que el instalador haya llamado a las acciones CostInitialize y CostFinalize.

FeatureValidStates determina la validez del estado consultando todos los componentes vinculados a la característica especificada sin tener en cuenta el estado instalado actual de ningún componente.

Los posibles estados válidos para una característica se determinan de la siguiente manera:

• Si la característica no contiene componentes, tanto INSTALLSTATE_LOCAL como INSTALLSTATE_SOURCE son estados válidos para la característica.
• Si al menos un componente de la característica tiene un atributo de msidbComponentAttributesLocalOnly o msidbComponentAttributesOptional, INSTALLSTATE_LOCAL es un estado válido para la característica.
• Si al menos un componente de la característica tiene un atributo de msidbComponentAttributesSourceOnly o msidbComponentAttributesOptional, INSTALLSTATE_SOURCE es un estado válido para la característica.
• Si un archivo de un componente que pertenece a la característica se revisa o de un origen comprimido, INSTALLSTATE_SOURCE no se incluye como un estado válido para la característica.
• INSTALLSTATE_ADVERTISE no es un estado válido si la característica no permite el anuncio (msidbFeatureAttributesDisallowAdvertise) o la característica requiere compatibilidad con la plataforma para el anuncio (msidbFeatureAttributesNoUnsupportedAdvertise) y la plataforma no la admite.
• INSTALLSTATE_ABSENT es un estado válido para la característica si sus atributos no incluyen msidbFeatureAttributesUIDisallowAbsent.
• Los estados válidos para las características secundarias marcadas para seguir la característica primaria (msidbFeatureAttributesFollowParent) se basan en la acción o el estado instalado de la característica primaria.

Si se produce un error en la propiedad, puede obtener información de error extendida mediante el método LastErrorRecord.

Requisitos

Requisito	Value
Versión	Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP
Archivo DLL	Msi.dll
IID	IID_ISession se define como 000C109E-0000-0000-C000-000000000046