Ação Personalizada Tipo 18
Essa ação personalizada chama um executável iniciado com uma linha de comando.
Fonte
O executável é gerado a partir de um arquivo instalado com o aplicativo. O campo Origem da Tabela CustomAction contém uma chave para a Tabela de Arquivos. O local do código de ação personalizada é determinado pela resolução do caminho de destino desse arquivo, portanto, essa ação personalizada deve ser chamada depois que o arquivo tiver sido instalado e antes de ser removido.
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 |
|---|---|---|
| msidbCustomActionTypeExe + msidbCustomActionTypeSourceFile | 0x012 | 18 |
Destino
A coluna Target da tabela CustomAction contém a cadeia de caracteres de linha de comando para o executável identificado na coluna Source.
Opções de processamento de retorno
Inclua bits de sinalizador opcionais na coluna Type da tabela CustomAction para especificar as opções de processamento de retorno. Para conferir uma descrição das opções e dos valores, consulte Opções de processamento de retorno da ação personalizada.
Opções de agendamento de execução
Inclua bits de sinalizador opcionais na coluna Type da tabela CustomAction para especificar as opções de agendamento de execução. Essas opções controlam a execução múltipla de ações personalizadas. Para conferir uma descrição das opções, consulte Opções de agendamento de execução de ação personalizada.
Opções de execução no script
Inclua bits de sinalizador opcionais na coluna Type da tabela CustomAction para especificar uma opção de execução no script. Essas opções copiam o código de ação para o script de execução, reversão ou confirmação. Para conferir uma descrição das opções, consulte Opções de execução no script de ação personalizada.
Valores de retorno
As ações personalizadas que são arquivos executáveis precisam retornar o valor 0, em caso de sucesso. O instalador interpreta qualquer outro valor retornado como uma falha. Para ignorar os valores retornados, defina o sinalizador de bits msidbCustomActionTypeContinue no campo Type da tabela CustomAction.
Comentários
Uma ação personalizada que inicia um executável usa uma linha de comando, que normalmente contém propriedades designadas dinamicamente. Caso essa também seja uma ação personalizada de execução adiada, o instalador usará CreateProcessAsUser ou CreateProcess para criar o processo quando a ação personalizada seja invocada do script de instalação.
As ações personalizadas que fazem referência a um arquivo instalado como sua origem, como a Ação Personalizada Tipo 18 (EXE), devem aderir às seguintes restrições de sequenciamento:
- A ação personalizada deve ser sequenciada após a Ação CostFinalize. Isso é para que a ação personalizada possa resolver o caminho necessário para localizar o EXE.
- Caso o arquivo de origem ainda não esteja instalado no computador, as ações personalizadas adiadas (no script) desse tipo deverão ser sequenciadas após a Ação InstallFiles.
- Se o arquivo de origem ainda não estiver instalado no computador, as ações personalizadas não adiadas desse tipo deverão ser sequenciadas após a ação InstallFinalize.
Tópicos relacionados