Função MsiSetComponentStateA (msiquery.h)

  • Artigo

A função MsiSetComponentState define um componente para o estado solicitado.

Sintaxe

UINT MsiSetComponentStateA(
  [in] MSIHANDLE    hInstall,
  [in] LPCSTR       szComponent,
  [in] INSTALLSTATE iState
);

Parâmetros

[in] hInstall

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

[in] szComponent

Especifica o nome do componente.

[in] iState

Especifica o estado a ser definido. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
INSTALLSTATE_ABSENT
 O componente foi desinstalado.
INSTALLSTATE_LOCAL
 O componente foi instalado na unidade local.
INSTALLSTATE_SOURCE
 O componente será executado de origem, CD ou rede.

Retornar valor

A função MsiSetComponentState retorna os seguintes valores:

Comentários

A função MsiSetComponentState solicita uma alteração no estado Action de um registro na tabela Component.

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.

Observação

O cabeçalho msiquery.h define MsiSetComponentState como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

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