Função MsiDoActionA (msiquery.h)

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.

Requisitos

Confira também

Funções de ação do instalador