Função MsiEndTransaction (msi.h)
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 |
|---|---|
|
Executa uma instalação de reversão para desfazer alterações no sistema que pertencem à transação aberta pela função MsiBeginTransaction . |
|
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 |
|---|---|
|
Uma transação só pode ser encerrada pelo proprietário atual. |
|
Não foi possível concluir uma instalação que pertença à transação. |
|
Uma instalação que pertence à transação ainda está em andamento. |
|
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 |