Tipo de ação personalizada 2
Esta ação personalizada chama um executável iniciado com uma linha de comando.
Fonte
O executável é gerado a partir de um fluxo binário temporário. O campo Origem da tabela CustomAction contém uma chave para a tabela Binary. A coluna Dados na tabela Binária contém os dados do fluxo. Um fluxo separado é alocado para cada linha.
Novos dados binários podem ser inseridos a partir de um arquivo usando MsiRecordSetStream seguido por MsiViewModify para inserir o registro na tabela. Quando a ação personalizada é invocada, os dados de fluxo são copiados para um arquivo temporário, que é processado dependendo do tipo de ação personalizada.
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 + msidbCustomActionTypeBinaryData | 0x002 | 2 |
Público-alvo
A coluna Destino da tabela CustomAction contém a cadeia de caracteres da linha de comando para o executável nomeado 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 no 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.
Quando uma tabela de banco de dados é exportada, cada fluxo é gravado como um arquivo separado na subpasta nomeada após a tabela, usando a chave primária como o nome do arquivo (coluna Nome para a tabela binária), com uma extensão padrão de ".ibd". O nome deve usar o formato 8.3 se o sistema de arquivos ou o sistema de controle de versão não suportar nomes de arquivo longos. O arquivo persistente substitui os dados de fluxo pelo nome de arquivo usado, para que os dados possam ser localizados quando a tabela for importada.
Tópicos relacionados