Compartilhar via


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 a instalação fornecida para uma ação personalizada de DLL ou obtida por meio MsiOpenPackage, MsiOpenPackageExou 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 simplificado. Ele é reservado para uso futuro e deve ser 0.

Valor de retorno

Essa função retorna UINT.

Observações

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 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 é se msiSequence for chamado de uma ação personalizada agendada na tabela InstallExecuteSequence entre as ações InstallInitialize e InstallFinalize. Ações que não atualizam o sistema, como AppSearch ou CostInitialize, podem ser chamadas.

Nota

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

Consulte também

Funções de ação do instalador