Tipo de ação personalizado 6
Essa ação personalizada é escrita em VBScript. Para obter mais informações, consulte Scripts.
Fonte
O script é gerado a partir de um fluxo binário temporário. O campo Origem da tabela CustomAction contém uma chave para a tabela binária . A coluna Dados na tabela Binária contém os dados de fluxo. Um fluxo separado é alocado para cada linha.
Novos dados binários podem ser inseridos de um arquivo usando MsiRecordSetStream seguidos 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 valor a seguir na coluna Type da tabela CustomAction para especificar o tipo numérico básico de uma ação personalizada de 32 bits.
| Constantes | Hexadecimal | Decimal |
|---|---|---|
| msidbCustomActionTypeVBScript + msidbCustomActionTypeBinaryData | 0x006 | 6 |
O Windows Installer pode usar ações personalizadas de 64 bits em sistemas operacionais de 64 bits. Uma ação personalizada de 64 bits baseada em scripts deve incluir o msidbCustomActionType64BitScript bit em seu tipo numérico. Para obter informações, consulte de Ações Personalizadas de 64 bits. Inclua o valor a seguir na coluna Type da tabela CustomAction para especificar o tipo numérico básico de uma ação personalizada de 64 bits.
| Constantes | Hexadecimal | Decimal |
|---|---|---|
| msidbCustomActionTypeVBScript + msidbCustomActionTypeBinaryData + msidbCustomActionType64BitScript | 0x0001006 | 4102 |
Alvo
O campo Destino da tabela CustomAction contém uma função de script opcional. O processamento primeiro envia o script para análise e, em seguida, chama a função de script opcional.
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
As funções opcionais escritas no script devem retornar um dos valores descritos em valores retornados de ações personalizadas JScript e VBScript.
Observações
Uma ação personalizada escrita em JScript ou VBScript requer a instalação do objeto de sessão . O instalador anexa o objeto Session ao script com o nome Session. Como o objeto session pode não existir durante uma reversão de instalação, uma ação personalizada adiada escrita no script deve usar um dos métodos ou propriedades do objeto Session descrito na seção Obter informações de contexto para ações personalizadas de execução adiada para recuperar seu contexto.
Quando uma tabela de banco de dados é exportada, cada fluxo é gravado como um arquivo separado na subpasta com o nome da tabela, usando a chave primária como o nome do arquivo (coluna Name para a tabela Binária), com uma extensão padrão de ".ibd". O nome deve usar o formato de nome de arquivo 8.3 se o sistema de arquivos ou o sistema de controle de versão não oferecer suporte a nomes de arquivo longos. O arquivo de arquivo persistente substitui os dados de fluxo pelo nome do arquivo usado, para que os dados possam ser localizados quando a tabela for importada.
Tópicos relacionados