Função MsiBeginTransactionA (msi.h)
A função MsiBeginTransaction inicia o 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 e versões anteriores: 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 |
---|---|
|
Quando 0 ou nenhum valor é definido, o Windows Installer fecha a interface do usuário da instalação anterior. |
|
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 possuir uma transação por vez.
[out] phChangeOfOwnerEvent
Esse parâmetro retorna um identificador para um evento definido quando a função MsiJoinTransaction altera o proprietário da transação para um novo proprietário. O proprietário atual pode usar isso para determinar quando a propriedade da transação foi alterada. Deixar uma transação sem um proprietário reverterá a transação.
Retornar valor
A função MsiBeginTransaction retorna os valores a seguir.
Valor | Significado |
---|---|
|
Não foi possível acessar o serviço de instalação. Essa função requer o serviço Windows Installer. |
|
Somente uma transação pode ser aberta em um sistema por vez. A função retornará esse erro se for chamada enquanto outra transação estiver em execução. |
|
Um parâmetro inválido é passado para a função . |
|
Instalações de reversão foram desabilitadas pela propriedade DISABLEROLLBACK ou pela política DisableRollback . |
Comentários
Observação
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. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
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 |