Compartilhar via


Tipo de ação personalizado 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 arquivo . O local do código de ação personalizado é 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 valor a seguir na coluna Type da tabela CustomAction para especificar o tipo numérico básico.

Constantes Hexadecimal Decimal
msidbCustomActionTypeExe + msidbCustomActionTypeSourceFile 0x012 18

 

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 Opções de Processamento de Retorno de Ação Personalizada.

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.

Opções de execução do In-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 no script de execução, reversão ou confirmação. Para obter uma descrição das opções, consulte Opções de Execução In-Script de Ação Personalizada.

Valores retornados

Ações personalizadas arquivos executáveis devem retornar um valor de 0 para êxito. O instalador interpreta qualquer outro valor retornado como falha. Para ignorar valores retornados, defina o msidbCustomActionTypeContinue sinalizador de bits no campo Tipo da tabela CustomAction.

Observações

Uma ação personalizada que inicia um executável usa uma linha de comando, que geralmente contém propriedades designadas dinamicamente. Se essa 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 do script de instalação.

Ações personalizadas que fazem referência a um arquivo instalado como sua origem, como o Tipo de Ação Personalizada 18 (EXE), devem seguir as 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 (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.

Custom_Actions

arquivos executáveis