Tipo de Ação Personalizada 21
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 é instalado com o aplicativo durante a sessão atual. O campo Origem da tabela CustomAction contém uma chave para a tabela Arquivos. O local do código de ação personalizada é determinado pela resolução do caminho de destino desse arquivo, portanto, essa ação personalizada deve ser chamada depois que o arquivo tiver sido instalado e antes de ser removido.
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 + msidbCustomActionTypeSourceFile | 0x015 | 21 |
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 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 + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript | 0x0001015 | 4117 |
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 o objeto Session de instalação. O instalador anexa o objeto Session ao script com o nome "Sessão". 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 descritos na seção Como obter informações de contexto para ações personalizadas de execução adiada a fim de recuperar o contexto.
As ações personalizadas que referenciam um arquivo instalado como a respectiva origem, como o Tipo de Ação Personalizada 21 (JScript), precisam seguir as seguintes restrições de sequenciamento:
- A ação personalizada precisa ser sequenciada após a ação CostFinalize. O motivo disso é que a ação personalizada possa resolver o caminho necessário para localizar o arquivo de origem que contém o JScript.
- Se o arquivo de origem ainda não estiver instalado no computador, as ações personalizadas adiadas (no script) desse tipo precisarão ser sequenciadas após a ação InstallFiles.
- Se o arquivo de origem ainda não estiver instalado no computador, as ações personalizadas não adiadas desse tipo deverão ser sequenciadas após a ação InstallFinalize.
Tópicos relacionados