Compartilhar via


Tipo de ação personalizado 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 Origem da tabela CustomAction em branco.

Valor do 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

 

Alvo

A coluna Destino 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 depois de formatar 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 depois de formatar a cadeia de caracteres contiver caracteres não numéricos, a cadeia de caracteres em si 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.

Opções de execução do In-Script

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

Valores retornados

Consulte valores de retorno da ação personalizada.

Observações

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

de tabela CustomAction

Ação Tipo Fonte Alvo
CAError1 19 [Prop1]
CAError2 19 Falha na instalação devido ao Erro2.
CAError3 19 25000
CAError4 19 [Prop2]

 

da tabela de propriedades

Propriedade Valor
Prop1 "Falha na instalação devido ao Erro1.".
Prop2 "25100"

 

de Tabela de Erros

Código Mensagem
25000 Falha na instalação devido ao Erro3.
25100 Falha na instalação devido ao Erro4.

 

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 Erro1.
CAError2 Falha na instalação devido ao Erro2.
CAError3 Falha na instalação devido ao Erro3.
CAError4 Falha na instalação devido ao Erro4.

 

Observe que, como a ordem de avaliação das condições de inicialização não pode ser garantida criando a 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