Tipo de ação personalizada 18
Esta 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 Arquivo . O local do código de ação personalizada é determinado pela resolução do caminho de destino para este arquivo; Portanto, essa ação personalizada deve ser chamada depois que o arquivo tiver sido instalado e antes de ser removido.
Valor do tipo
Inclua o seguinte valor na coluna Tipo da tabela CustomAction para especificar o tipo numérico básico.
Constantes | Hexadecimal | Decimal |
---|---|---|
msidbCustomActionTypeExe + msidbCustomActionTypeFile | 0x012 | 18 |
Público-alvo
A coluna Destino da tabela CustomAction contém a cadeia de caracteres de linha de comando para o executável identificado na coluna Origem.
Opções de processamento de retorno
Inclua bits de sinalizador opcionais na coluna Tipo da tabela CustomAction para especificar opções de processamento de retorno. Para obter uma descrição das opções e dos valores, consulte Custom Action Return Processing Options.
Opções de agendamento de execução
Inclua bits de sinalizador opcionais na coluna Tipo da tabela CustomAction para especificar opções de agendamento de execução. Essas opções controlam a execução múltipla de ações personalizadas. Para obter uma descrição das opções, consulte Opções de agendamento de execução de ação personalizada.
In-Script opções de execução
Inclua bits de sinalizador opcionais na coluna Tipo da tabela CustomAction para especificar uma opção de execução em script. Essas opções copiam o código de ação para o script de execução, reversão ou confirmação. Para obter uma descrição das opções, consulte Custom Action In-Script Execution Options.
Valores de retorno
As ações personalizadas que são arquivos executáveis devem retornar um valor de 0 para êxito. O instalador interpreta qualquer outro valor de retorno como falha. Para ignorar valores de retorno, defina o sinalizador msidbCustomActionTypeContinue bit no campo Type da tabela CustomAction.
Comentários
Uma ação personalizada que inicia um executável usa uma linha de comando, que geralmente contém propriedades que são designadas dinamicamente. Se esta também for uma ação personalizada de execução adiada , o instalador usará CreateProcessAsUser ou CreateProcess para criar o processo quando a ação personalizada for invocada a partir do script de instalação.
As ações personalizadas que fazem referência a um arquivo instalado como origem, como o Tipo de Ação Personalizada 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.
- Se o arquivo de origem ainda não estiver instalado no computador, as ações personalizadas adiadas (in-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, ações personalizadas não adiadas desse tipo deverão ser sequenciadas após a ação InstallFinalize.
Tópicos relacionados