Compartilhar via


Ação personalizada tipo 19

Essa ação personalizada exibe uma mensagem de erro especificada, retorna uma 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 Error.

Fonte

Deixe a coluna Source da tabela CustomAction em branco.

Valor de tipo

Inclua o valor a seguir na coluna Type da tabela CustomAction para especificar o tipo numérico básico.

Constantes Hexadecimal Decimal
msidbCustomActionTypeTextData + msidbCustomActionTypeSourceFile 0x013 19

 

Destino

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

Opções de processamento de retornos

A ação personalizada não usa opções.

Opções de agendamento de execução

A ação personalizada não usa opções.

Opções de execução no script

A ação personalizada não usa opções.

Valores de retorno

Confira Valores retornados da 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 Destino
CAError1 19 [Prop1]
CAError2 19 Falha na instalação devido ao Error2.
CAError3 19 25000
CAError4 19 [Prop2]

 

Tabela Property

Propriedade Valor
Prop1 “Falha na instalação devido ao Error1.”
Prop2 "25100"

 

Tabela Error

Código Mensagem
25000 Falha na instalação devido ao Error3.
25100 Falha na instalação devido ao Error4.

 

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

Ação personalizada Cadeia de caracteres de mensagem retornada
CAError1 Falha na instalação devido ao Error1.
CAError2 Falha na instalação devido ao Error2.
CAError3 Falha na instalação devido ao Error3.
CAError4 Falha na instalação devido ao 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 19 em sua instalação para avaliar as condições em uma ordem específica.

Custom_Actions