Partilhar via

Propriedade Session.FeatureValidStates

  • Artigo

A propriedade FeatureValidStates do objeto Session retorna um inteiro que representa sinalizadores de bit com cada bit relevante representando um estado de instalação válido para o recurso especificado.

Esta propriedade é somente para leitura.

Sintaxe

propVal = Session.FeatureValidStates

Valor da propriedade

Nome da cadeia de caracteres necessário do item de recurso cujos estados de instalação válidos devem ser recuperados.

Comentários

O valor retornado é composto por sinalizadores de bits da seguinte maneira. Bit 0: se definido, Local será um estado válido. Bit 1: se definido, a Origem será um estado válido.

A propriedade FeatureValidStates só é bem-sucedida depois que o instalador chama as ações CostInitialize e CostFinalize.

FeatureValidStates determina a validade do estado consultando todos os componentes que estão vinculados ao recurso especificado sem levar em conta o estado atual instalado de qualquer componente.

Os estados válidos possíveis para um recurso são determinados da seguinte maneira:

  • Se o recurso não contiver componentes, INSTALLSTATE_LOCAL e INSTALLSTATE_SOURCE serão estados válidos para o recurso.
  • Se pelo menos um componente do recurso tiver um atributo de msidbComponentAttributesLocalOnly ou msidbComponentAttributesOptional, INSTALLSTATE_LOCAL será um estado válido para o recurso.
  • Se pelo menos um componente do recurso tiver um atributo de msidbComponentAttributesSourceOnly ou msidbComponentAttributesOptional, INSTALLSTATE_SOURCE será um estado válido para o recurso.
  • Se um arquivo de um componente pertencente ao recurso for corrigido ou de uma fonte compactada, INSTALLSTATE_SOURCE não será incluído como um estado válido para o recurso.
  • INSTALLSTATE_ADVERTISE não for um estado válido se o recurso não permitir anúncio (msidbFeatureAttributesDisallowAdvertise) ou o recurso exigir suporte de plataforma para anúncio (msidbFeatureAttributesNoUnsupportedAdvertise) e a plataforma não oferecer suporte a ele.
  • INSTALLSTATE_ABSENT é um estado válido para o recurso se seus atributos não incluirem msidbFeatureAttributesUIDisallowAbsent.
  • Os estados válidos para recursos filho marcados para seguir o recurso pai (msidbFeatureAttributesFollowParent) baseiam-se na ação do recurso pai ou no estado instalado.

Em caso de falha da propriedade, obtenha mais informações sobre erros usando o método LastErrorRecord.

Requisitos

Requisito Valor
Versão
 Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
DLL
Msi.dll
IID
 O IID_ISession é definido como 000C109E-0000-0000-C000-000000000046