Função MsiDoActionA (msiquery.h)

  • Artigo

A função MsiDoAction executa uma ação interna, uma ação personalizada ou uma ação do assistente de interface do usuário.

Sintaxe

UINT MsiDoActionA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szAction
);

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] szAction

Especifica a ação a ser executada.

Valor retornado

Essa função retorna UINT.

Comentários

A função MsiDoAction executa a ação que corresponde ao nome fornecido. Se o nome não for reconhecido pelo instalador como uma ação interna ou como uma ação personalizada na tabela CustomAction, o nome será passado para o objeto manipulador de interface do usuário, que pode invocar uma função ou uma caixa de diálogo. Se um nome de ação nula for fornecido, o instalador usará o valor maiúsculo da propriedade ACTION como a ação a ser executada. Se nenhum valor de propriedade for definido, a ação padrão será executada, definida como "INSTALL".

Ações que atualizam o sistema, como as ações InstallFiles e WriteRegistryValues , não podem ser executadas chamando MsiDoAction. A exceção a essa regra será se MsiDoAction for chamado de uma ação personalizada agendada na tabela InstallExecuteSequence entre as ações InstallInitialize e InstallFinalize. As ações que não atualizam o sistema, como AppSearch ou CostInitialize, podem ser chamadas.

Observação

O cabeçalho msiquery.h define MsiDoAction 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

   
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 ação do instalador