Función MsiEndTransaction (msi.h)

  • Artículo

La función MsiEndTransaction puede confirmar o revertir todas las instalaciones que pertenecen a la transacción abierta por la función MsiBeginTransaction . El propietario actual de la transacción debe llamar a esta función.

Windows Installer 4.0 y versiones anteriores: No se admite. Esta función está disponible a partir de Windows Installer 4.5.

Sintaxis

UINT MsiEndTransaction(
  [in] DWORD dwTransactionState
);

Parámetros

[in] dwTransactionState

El valor de este parámetro determina si el instalador confirma o revierte todas las instalaciones que pertenecen a la transacción. El valor puede ser uno de los siguientes.

Valor Significado
MSITRANSACTIONSTATE_ROLLBACK
 Realiza una instalación de reversión para deshacer los cambios en el sistema que pertenece a la transacción abierta por la función MsiBeginTransaction .
MSITRANSACTIONSTATE_COMMIT
 Confirma todos los cambios en el sistema que pertenece a la transacción. Ejecuta cualquier acción personalizada de confirmación y confirma en el sistema los cambios realizados en los ensamblados de Win32 o Common Language Runtime. Elimina el script de reversión y, después de usar esta opción, los cambios de la transacción ya no se pueden deshacer con una instalación de reversión.

Valor devuelto

La función MsiEndTransaction devuelve los valores siguientes.

Valor Significado
ERROR_ACCESS_DENIED
 Solo el propietario actual puede finalizar una transacción.
ERROR_INSTALL_FAILURE
 No se pudo completar una instalación que pertenece a la transacción.
ERROR_INSTALL_ALREADY_RUNNING
 Una instalación que pertenece a la transacción sigue en curso.
ERROR_ROLLBACK_DISABLED
 No se completó una instalación que pertenece a la transacción. Durante la instalación, la acción DisableRollback deshabilitó las instalaciones de reversión del paquete. El instalador revierte la instalación hasta el punto en el que se deshabilitó la reversión y la función devuelve este error.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.5 en Windows Vista, Windows XP, Windows Server 2003 y Windows Server 2008. Consulte Windows Installer para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
Plataforma de destino Windows
Encabezado msi.h
Library Msi.lib
Archivo DLL Msi.dll

Consulte también

Instalaciones de varios paquetes