Partilhar via


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.

Custom_Actions

arquivos executáveis