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.
| Ação | Tipo | Fonte | Destino |
|---|---|---|---|
| CAError1 | 19 | [Prop1] | |
| CAError2 | 19 | Falha na instalação devido ao Error2. | |
| CAError3 | 19 | 25000 | |
| CAError4 | 19 | [Prop2] |
| Propriedade | Valor |
|---|---|
| Prop1 | “Falha na instalação devido ao Error1.” |
| Prop2 | "25100" |
| 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.
Tópicos relacionados