Função MsiBeginTransactionA (msi.h)

Artigo
11/20/2024

A função MsiBeginTransaction inicia de processamento de transações de uma instalação de vários pacotes e retorna um identificador para a transação. A função MsiEndTransaction encerra a transação.

Windows Installer 4.0 eanteriores: sem suporte. Essa função está disponível a partir do Windows Installer 4.5.

Sintaxe

UINT MsiBeginTransactionA(
  [in]  LPCSTR    szName,
  [in]  DWORD     dwTransactionAttributes,
  [out] MSIHANDLE *phTransactionHandle,
  [out] HANDLE    *phChangeOfOwnerEvent
);

Parâmetros

[in] szName

Nome da instalação de vários pacotes.

[in] dwTransactionAttributes

Atributos da instalação de vários pacotes.

Valor	Significado
0	Quando 0 ou nenhum valor é definido, o Windows Installer fecha a interface do usuário da instalação anterior.
MSITRANSACTION_CHAIN_EMBEDDEDUI	Defina esse atributo para solicitar que o Windows Installer não desligue a interface do usuário inserida até que a transação seja concluída.

[out] phTransactionHandle

A ID da transação é um valor MSIHANDLE que identifica a transação. Somente um processo pode ter uma transação por vez.

[out] phChangeOfOwnerEvent

Esse parâmetro retorna um identificador para um evento que é definido quando a função MsiJoinTransaction altera o proprietário da transação para um novo proprietário. O proprietário atual pode usá-lo para determinar quando a propriedade da transação foi alterada. Deixar uma transação sem um proprietário reverterá a transação.

Valor de retorno

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

Valor	Significado
ERROR_INSTALL_SERVICE_FAILURE	Não foi possível acessar o serviço de instalação. Essa função requer o serviço Windows Installer.
ERROR_INSTALL_ALREADY_RUNNING	Somente uma transação pode ser aberta em um sistema de cada vez. A função retornará esse erro se for chamada enquanto outra transação estiver em execução.
ERROR_INVALID_PARAMETER	Um parâmetro inválido é passado para a função.
ERROR_ROLLBACK_DISABLED	instalações de reversão foram desabilitadas pela propriedade DISABLEROLLBACK ou política de DisableRollback.

Observações

Nota

O cabeçalho msi.h define MsiBeginTransaction como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows Installer 5.0 no Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.5 no Windows Vista, Windows XP, Windows Server 2003 e Windows Server 2008. Consulte os Requisitos de Run-Time do Windows Installer para obter informações sobre o service pack mínimo do Windows exigido por uma versão do Windows Installer.
da Plataforma de Destino	Windows
cabeçalho	msi.h
biblioteca	Msi.lib
de DLL	Msi.dll

Consulte também

várias instalações de pacote

Compartilhar via