Función MsiBeginTransactionA (msi.h)

  • Artículo

La función MsiBeginTransaction inicia el 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 se establece 0 o ningún valor, Windows Installer cierra la interfaz de usuario de la instalación anterior.
MSITRANSACTION_CHAIN_EMBEDDEDUI
 Establezca este atributo para solicitar que Windows Installer no apague 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

Las instalaciones de reversión se han deshabilitado mediante la propiedad DISABLEROLLBACK o la directiva DisableRollback .

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

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