Partilhar via


Método Session.SetInstallLevel

O método SetInstallLevel do objeto Session define o nível de instalação da instalação atual como um valor especificado e recalcula os estados Select e Installed para todos os recursos na tabela Feature. Ele também define o Estado de ação de cada componente na tabela Component com base no novo nível.

Sintaxe

Session.SetInstallLevel(
  installLevel
)

Parâmetros

installLevel

Novo nível de instalação solicitado necessário.

Valor retornado

Esse método não retorna um valor.

Comentários

A ação CostInitialize deve ser executada antes de chamar SetInstallLevel.

Se 0 for passado para o parâmetro installLevel, o nível de instalação atual não será alterado, mas todos os recursos ainda serão atualizados com base no nível de instalação atual. Por exemplo, essa funcionalidade pode ser usada pelo módulo Manipulador para redefinir todas as seleções para seus estados padrão iniciais a qualquer momento no processo de seleção da interface do usuário.

Em caso de falha do método, obtenha informações sobre erros estendidos 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