Tipo de Ação Personalizada 34
Essa ação personalizada chama um executável iniciado com uma linha de comando. Para obter mais informações, confira Arquivos executáveis.
Fonte
O executável é gerado com base em um arquivo. O campo Source da tabela CustomAction contém uma chave na tabela Directory. A entrada da tabela Directory referenciada é usada para resolver o caminho completo para um diretório de trabalho. Isso não precisa ser o caminho para o diretório que contém o executável.
Valor de Type
Inclua o valor a seguir na coluna Type da tabela CustomAction para especificar o tipo numérico básico.
| Constantes | Hexadecimal | Decimal |
|---|---|---|
| msidbCustomActionTypeExe + msidbCustomActionTypeDirectory | 0x022 | 34 |
Destino
A coluna Target da tabela CustomAction contém o caminho completo e o nome do arquivo executável seguidos de argumentos opcionais para o executável. O caminho completo e o nome para o arquivo executável são obrigatórios. Os nomes de arquivos ou caminhos longos precisam ser escritos entre aspas. O valor é tratado como texto formatado e pode conter referências a propriedades, arquivos, diretórios ou outros atributos de texto formatados.
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 ver uma descrição das opções e dos valores, confira 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. 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.
Tópicos relacionados