Compartilhar via


Tipo de ação personalizado 22

Essa 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 personalizado é 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 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 + msidbCustomActionTypeSourceFile 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 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 + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript 0x0001016 4118

 

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 objeto de sessão. Esse é do tipo objeto de sessão e o instalador o anexa ao script com o nome "Sessão". 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.

Ações personalizadas que fazem referência a um arquivo instalado como sua origem, como o Tipo de Ação Personalizada 22 (VBcript), devem seguir as 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 (no 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, as ações personalizadas não adiadas desse tipo deverão ser sequenciadas após a ação InstallFinalize.

Custom_Actions