Tipo de ação personalizada 22
Esta ação personalizada é escrita em VBScript. Consulte também 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 Arquivo . O local do código de ação personalizada é determinado pela resolução do caminho de destino para este arquivo; Portanto, essa ação personalizada deve ser chamada depois que o arquivo tiver sido instalado e antes de ser removido.
Valor do tipo
Inclua o seguinte valor na coluna Tipo da tabela CustomAction para especificar o tipo numérico básico de uma ação personalizada de 32 bits.
| Constantes | Hexadecimal | Decimal |
|---|---|---|
| msidbCustomActionTypeVBScript + msidbCustomActionTypeFile | 0x016 | 22 |
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 Ações personalizadas de 64 bits. Inclua o seguinte valor na coluna Tipo da tabela CustomAction para especificar o tipo numérico básico de uma ação personalizada de 64 bits.
| Constantes | Hexadecimal | Decimal |
|---|---|---|
| msidbCustomActionTypeVBScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript | 0x0001016 | 4118 |
Público-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 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 em 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 funções opcionais escritas em script devem retornar um dos valores descritos em Return Values of JScript and VBScript Custom Actions.
Comentários
Uma ação personalizada escrita em JScript ou VBScript requer a instalação Session Object. Este é do tipo Session Object e o instalador anexa-o 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 em script deve usar um dos métodos ou propriedades do objeto Session descrito na seção Obtendo informações de contexto para ações personalizadas de execução adiada recuperar seu contexto.
As ações personalizadas que fazem referência a um arquivo instalado como origem, como o Tipo de Ação Personalizada 22 (VBcript), devem aderir às seguintes restrições de sequenciamento:
- A ação personalizada deve ser sequenciada após a ação CostFinalize. Isso é para que a ação personalizada possa resolver o caminho necessário para localizar o arquivo de origem que contém o VBScript.
- Se o arquivo de origem ainda não estiver instalado no computador, as ações personalizadas adiadas (in-script) desse tipo deverão ser sequenciadas após a ação InstallFiles.
- Se o arquivo de origem ainda não estiver instalado no computador, ações personalizadas não adiadas desse tipo deverão ser sequenciadas após a ação InstallFinalize.
Tópicos relacionados