Compartir a través de

Función MsiBeginTransactionA (msi.h)

  • Artículo

La función MsiBeginTransaction inicia procesamiento de transacciones de una instalación de varios paquetes y devuelve un identificador para la transacción. La función MsiEndTransaction finaliza la transacció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 MsiBeginTransactionA(
  [in]  LPCSTR    szName,
  [in]  DWORD     dwTransactionAttributes,
  [out] MSIHANDLE *phTransactionHandle,
  [out] HANDLE    *phChangeOfOwnerEvent
);

Parámetros

[in] szName

Nombre de la instalación de varios paquetes.

[in] dwTransactionAttributes

Atributos de la instalación de varios paquetes.

Valor Significado
0
 Cuando 0 o ningún valor se establece, Windows Installer cierra la interfaz de usuario de la instalación anterior.
MSITRANSACTION_CHAIN_EMBEDDEDUI
 Establezca este atributo para solicitar que Windows Installer no cierre la interfaz de usuario insertada hasta que se complete la transacción.

[out] phTransactionHandle

El identificador de transacción es un valor MSIHANDLE que identifica la transacción. Solo un proceso puede poseer una transacción a la vez.

[out] phChangeOfOwnerEvent

Este parámetro devuelve un identificador a un evento que se establece cuando la función MsiJoinTransaction cambia el propietario de la transacción a un nuevo propietario. El propietario actual puede usarlo para determinar cuándo ha cambiado la propiedad de la transacción. Si se deja una transacción sin un propietario, se revertirá la transacción.

Valor devuelto

La función msiBeginTransaction devuelve los valores siguientes.

Valor Significado
ERROR_INSTALL_SERVICE_FAILURE
 No se pudo acceder al servicio de instalación. Esta función requiere el servicio Windows Installer.
ERROR_INSTALL_ALREADY_RUNNING
 Solo se puede abrir una transacción en un sistema a la vez. La función devuelve este error si se llama mientras se ejecuta otra transacción.
ERROR_INVALID_PARAMETER
 Se pasa un parámetro no válido a la función .
ERROR_ROLLBACK_DISABLED

la propiedad DISABLEROLLBACK o la directiva de DisableRollback han deshabilita do las instalaciones de reversión.

Observaciones

Nota

El encabezado msi.h define MsiBeginTransaction como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido 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 Run-Time Requirements (Requisitos de Windows Installer) para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.
de la plataforma de destino de Windows
encabezado de msi.h
biblioteca de Msi.lib
DLL de Msi.dll

Consulte también

instalación de varios paquetes