Compartilhar via

Função MsiEndTransaction (msi.h)

  • Artigo

A função MsiEndTransaction pode confirmar ou reverter todas as instalações pertencentes à transação aberta pela função MsiBeginTransaction . Essa função deve ser chamada pelo proprietário atual da transação.

Windows Installer 4.0 e versões anteriores: Sem suporte. Essa função está disponível a partir do Windows Installer 4.5.

Sintaxe

UINT MsiEndTransaction(
  [in] DWORD dwTransactionState
);

Parâmetros

[in] dwTransactionState

O valor desse parâmetro determina se o instalador confirma ou reverte todas as instalações pertencentes à transação. O valor pode ser um dos seguintes.

Valor Significado
MSITRANSACTIONSTATE_ROLLBACK
 Executa uma instalação de reversão para desfazer alterações no sistema que pertencem à transação aberta pela função MsiBeginTransaction .
MSITRANSACTIONSTATE_COMMIT
 Confirma todas as alterações no sistema que pertencem à transação. Executa qualquer Confirmação de Ações Personalizadas e confirma ao sistema todas as alterações em assemblies Win32 ou Common Language Runtime. Exclui o script de reversão e, depois de usar essa opção, as alterações da transação não podem mais ser desfeitas com uma Instalação de Reversão.

Retornar valor

A função MsiEndTransaction retorna os valores a seguir.

Valor Significado
ERROR_ACCESS_DENIED
 Uma transação só pode ser encerrada pelo proprietário atual.
ERROR_INSTALL_FAILURE
 Não foi possível concluir uma instalação que pertença à transação.
ERROR_INSTALL_ALREADY_RUNNING
 Uma instalação que pertence à transação ainda está em andamento.
ERROR_ROLLBACK_DISABLED
 Uma instalação que pertence à transação não foi concluída. Durante a instalação, a ação DisableRollbackdesabilitou as instalações de reversão do pacote. O instalador reverte a instalação até o ponto em que a reversão foi desabilitada e a função retorna esse erro.

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.5 no Windows Vista, Windows XP, Windows Server 2003 e Windows Server 2008. Confira os Requisitos de tempo de execução do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
Plataforma de Destino Windows
Cabeçalho msi.h
Biblioteca Msi.lib
DLL Msi.dll

Confira também

Várias instalações de pacote