Função MsiSequenceA (msiquery.h)

A função MsiSequence executa outra sequência de ações, conforme descrito na tabela especificada.

Sintaxe

UINT MsiSequenceA(
  [in] MSIHANDLE hInstall,
  [in] LPCSTR    szTable,
  [in] INT       iSequenceMode
);

Parâmetros

[in] hInstall

Manipule para a instalação fornecida a uma ação personalizada de DLL ou obtida por meio de MsiOpenPackage, MsiOpenPackageEx ou MsiOpenProduct.

[in] szTable

Especifica o nome da tabela que contém a sequência de ações.

[in] iSequenceMode

No momento, esse parâmetro não foi implementado. Ele é reservado para uso futuro e deve ser 0.

Retornar valor

Essa função retorna UINT.

Comentários

A função MsiSequence consulta a tabela especificada, ordenando as ações pelos números na coluna Sequência. Para cada linha recuperada, uma ação é executada, desde que qualquer expressão de condição fornecida não seja avaliada como FALSE.

Uma sequência de ações que contém todas as ações que atualizam o sistema, como as ações InstallFiles e WriteRegistryValues , não pode ser executada chamando MsiSequence. A exceção a essa regra será se MsiSequence for chamado de uma ação personalizada agendada na tabela InstallExecuteSequence entre as ações InstallInitialize e InstallFinalize. As ações que não atualizam o sistema, como AppSearch ou CostInitialize, podem ser chamadas.

Observação

O cabeçalho msiquery.h define MsiSequence 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.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
Plataforma de Destino	Windows
Cabeçalho	msiquery.h
Biblioteca	Msi.lib
DLL	Msi.dll

Confira também

Funções de ação do instalador