Função MsiDoActionA (msiquery.h)

Artigo
11/20/2024

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 a instalação fornecida para uma ação personalizada de DLL ou obtida por meio MsiOpenPackage, MsiOpenPackageExou MsiOpenProduct.

[in] szAction

Especifica a ação a ser executada.

Valor de retorno

Essa função retorna UINT.

Observações

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 da maiúscula 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 é se MsiDoAction é chamado de uma ação personalizada agendada na tabela InstallExecuteSequence entre as ações InstallInitialize e InstallFinalize. Ações que não atualizam o sistema, como AppSearch ou CostInitialize, podem ser chamadas.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Installer 5.0 no Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou Windows Vista. Windows Installer no Windows Server 2003 ou Windows XP
da Plataforma de Destino	Windows
cabeçalho	msiquery.h
biblioteca	Msi.lib
de DLL	Msi.dll

Consulte também

Funções de ação do instalador

Compartilhar via