Ação personalizada tipo 5
Essa ação personalizada é escrita em JScript, como ECMA 262. O Windows Installer não dá suporte para JScript 1.0. Para obter mais informações, confira Scripts.
Fonte
O script é gerado com base em um fluxo binário temporário. O campo Source da tabela CustomAction contém uma chave para a tabela Binary. A coluna Data da tabela Binary contém os dados de fluxo. Um fluxo separado é alocado para cada linha.
Novos dados binários podem ser inseridos por meio de um arquivo usando MsiRecordSetStream seguido de 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 conforme o tipo de ação personalizada.
Valor de 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 |
|---|---|---|
| msidbCustomActionTypeJScript + msidbCustomActionTypeBinaryData | 0x05 | 5 |
O Windows Installer poderá usar ações personalizadas de 64 bits em sistemas operacionais de 64 bits. Uma ação personalizada de 64 bits baseada em scripts precisa incluir o bit msidbCustomActionType64BitScript no tipo numérico. Para obter mais informações, confira 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 |
|---|---|---|
| msidbCustomActionTypeJScript + msidbCustomActionTypeBinaryData + msidbCustomActionType64BitScript | 0x0001005 | 4101 |
Destino
O campo Destino da tabela CustomAction contém uma função de script opcional. O processamento envia primeiro o script para análise e, em seguida, chama a função de script opcional.
Opções de processamento de retornos
Inclua bits de sinalizador opcionais na coluna Type da tabela CustomAction para especificar as opções de processamento de retorno. Para conferir uma descrição das opções e dos valores, consulte 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 funções opcionais escritas no script precisam retornar um dos valores descritos em Valores retornados de ações personalizadas do JScript e VBScript.
Comentários
Uma ação personalizada escrita em JScript ou VBScript exige a instalação do objeto Session. O instalador anexa o objeto Session ao script com o nome Session. Como o objeto Session talvez não exista durante uma reversão de instalação, uma ação personalizada adiada escrita no script precisa usar um dos métodos ou uma das propriedades do objeto Session descritas na seção Como obter informações de contexto para ações personalizadas de execução adiada para recuperar o contexto.
Quando uma tabela de banco de dados é exportada, cada fluxo é gravado como um arquivo separado na subpasta com o mesmo nome da tabela, usando a chave primária como o nome do arquivo (coluna Name da tabela Binary), com a extensão padrão ".ibd". O nome deverá usar o formato de nome de arquivo 8.3 se o sistema de arquivos ou o sistema de controle de versão não der suporte a nomes de arquivos longos. O arquivo morto 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