Compartilhar via


Função MsiSetInstallLevel (msiquery.h)

A função MsiSetInstallLevel define o nível de instalação de uma instalação completa do produto.

Sintaxe

UINT MsiSetInstallLevel(
  [in] MSIHANDLE hInstall,
  [in] int       iInstallLevel
);

Parâmetros

[in] hInstall

Manipule para a instalação fornecida a uma ação personalizada de DLL ou obtida usando MsiOpenPackage, MsiOpenPackageEx ou MsiOpenProduct.

[in] iInstallLevel

O nível de instalação.

Retornar valor

A função MsiSetInstallLevel retorna um dos seguintes valores:

Comentários

A função MsiSetInstallLevel define o seguinte:

  • O nível de instalação da instalação atual para um valor especificado.
  • Os estados Selecionar e Instalado para todos os recursos na tabela Recurso.
  • O estado Ação de cada componente na tabela Componente, com base no novo nível.
Para qualquer instalação, há um nível de instalação definido, que é um valor integral de 1 a 32.767. O valor inicial é determinado pela propriedade INSTALLLEVEL , que é definida na Tabela de Propriedades.

Se 0 (zero) ou um número negativo for passado no parâmetro iInstallLevel , 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. Para obter mais informações, consulte Chamando funções de banco de dados de programas.

Se a função falhar, você poderá obter informações de erro estendidas usando MsiGetLastErrorRecord.

Requisitos

Requisito Valor
Cliente mínimo com suporte 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
Plataforma de Destino Windows
Cabeçalho msiquery.h
Biblioteca Msi.lib
DLL Msi.dll

Confira também

Funções de seleção do instalador