Partilhar via

Tipo de ação personalizada 19

  • Artigo

Essa ação personalizada exibe uma mensagem de erro especificada, retorna a falha e encerra a instalação. A mensagem de erro exibida pode ser fornecida como uma cadeia de caracteres ou como um índice na tabela Erro.

Fonte

Deixe a coluna Origem da tabela CustomAction em branco.

Valor do tipo

Inclua o seguinte valor na coluna Tipo da tabela CustomAction para especificar o tipo numérico básico.

Constantes Hexadecimal Decimal
msidbCustomActionTypeTextData + msidbCustomActionTypeFile 0x013 19

 

Público-alvo

A coluna Destino da tabela CustomAction contém uma cadeia de caracteres de texto formatada usando a funcionalidade especificada noMsiFormatRecord (sem os especificadoresde campo numérico). Os parâmetros a serem substituídos estão entre colchetes, [...], e podem ser propriedades, variáveis de ambiente (prefixo%), caminhos de arquivo (prefixo #) ou caminhos de diretório de componentes (prefixo $). Se, depois de formatar, a cadeia de caracteres for avaliada como um inteiro, esse inteiro será usado como um índice na tabela Erro para recuperar a mensagem a ser exibida. Se depois de formatar a cadeia de caracteres contiver caracteres não numéricos, a própria cadeia de caracteres será exibida como a mensagem.

Opções de processamento de retorno

A ação personalizada não usa nenhuma opção.

Opções de agendamento de execução

A ação personalizada não usa nenhuma opção.

In-Script opções de execução

A ação personalizada não usa nenhuma opção.

Valores de retorno

Consulte Valores de retorno de ação personalizada.

Comentários

Por exemplo, as ações personalizadas CAError1, CAError2, CAError3 e CAError4 retornam essas mensagens.

Tabela CustomAction

Ação Tipo Fonte Público-alvo
CAError1 19 [Prop1]
CAError2 19 Falha de instalação devido a Error2.
CAError3 19 25000
CAError4 19 [Prop2]

 

Tabela de Propriedades

Propriedade Valor
Prop1 "Falha de instalação devido a Error1."
Prop2 "25100"

 

Tabela de Erros

Código Mensagem
25000 Falha de instalação devido a Error3.
25100 Falha de instalação devido a Error4.

 

Essas ações personalizadas retornam as seguintes mensagens de erro:

Ação personalizada Cadeia de caracteres de mensagem retornada
CAError1 Falha de instalação devido a Error1.
CAError2 Falha de instalação devido a Error2.
CAError3 Falha de instalação devido a Error3.
CAError4 Falha de instalação devido a Error4.

 

Observe que, como a ordem de avaliação das condições de inicialização não pode ser garantida pela criação da tabela LaunchCondition, você deve usar ações personalizadas do Tipo de Ação Personalizada 19 em sua instalação para avaliar as condições em uma ordem específica.

Custom_Actions