Partilhar via


Tabela InstallUISequence

A tabela InstallUISequence lista as ações executadas quando a ação INSTALL de nível superior é executada e o nível de interface do usuário interno é definido como interface do usuário completa ou interface do usuário reduzida. O instalador vai ignorar as ações dessa tabela se o nível de interface do usuário for definido como interface do usuário básica ou nenhuma interface do usuário. Confira Sobre a interface do usuário.

As ações na sequência de instalação até a ação InstallValidate e as caixas de diálogo de saída estão localizadas na tabela InstallUISequence. Todas as ações de InstallValidate até o final da sequência de instalação estão na tabela InstallExecuteSequence. Como a tabela InstallExecuteSequence precisa ficar sozinha, ela tem todas as ações de inicialização necessárias, como a ação LaunchConditions, CostInitialize, FileCost, além de CostFinalize e ExecuteAction.

A tabela InstallUISequence tem as colunas a seguir.

Coluna Tipo Chave Nullable
Ação Identificador S N
Condição Condição N S
Sequência Inteiro N S

 

Colunas

Action

Nome da ação a ser executada. Essa é uma ação interna, uma ação personalizada ou um assistente de interface do usuário.

Chave de tabela primária.

Condition

Esse campo contém uma expressão condicional. Se a expressão for avaliada como False, a ação será ignorada. Se a sintaxe da expressão for inválida, a sequência será encerrada, retornando iesBadActionData. Para obter informações sobre a sintaxe das instruções condicionais, confira Sintaxe das instruções condicionais.

Sequence

O número dessa coluna determina a posição da sequência na qual essa ação é executada.

Um valor positivo representa a posição da sequência. Um valor Null indica que a ação nunca é executada. Os valores negativos a seguir indicam que essa ação será executada se o instalador retornar o sinalizador de término associado. Cada sinalizador de término (valor negativo) pode ser usado com, no máximo, uma ação. Várias ações podem ter sinalizadores de término, mas precisam ser sinalizadores diferentes. Normalmente, os sinalizadores de término (valores negativos) são usados com caixas de diálogo.

Sinalizador de término Valor Descrição
msiDoActionStatusSuccess -1 Conclusão bem-sucedida. Usado com caixas de diálogo Exit.
msiDoActionStatusUserExit -2 O usuário encerra a instalação. Usado com caixas de diálogo UserExit.
msiDoActionStatusFailure -3 A saída fatal é encerrada. Usado com caixas de diálogo FatalError.
msiDoActionStatusSuspend -4 A instalação é suspensa.

 

Zero, todos os outros números negativos ou um valor Null indicam que a ação nunca é executada.

Comentários

O texto localizado associado para exibição de progresso ou log é especificado na tabela ActionText.

Para ver um exemplo de uma tabela de sequência, confira Como usar uma tabela de sequência.

Validação

ICE03
ICE06
ICE12
ICE13
ICE20
ICE26
ICE27
ICE28
ICE46
ICE75
ICE79
ICE82
ICE86