Share via

Tipo de ação personalizada 22

  • Artigo

Essa ação personalizada é escrita em VBScript. Confira 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 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
msidbCustomActionTypeVBScript + msidbCustomActionTypeSourceFile 0x016 22

 

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
msidbCustomActionTypeVBScript + msidbCustomActionTypeSourceFile + msidbCustomActionType64BitScript 0x0001016 4118

 

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 Sessão de instalação. Essa ação é do tipo de objeto Sessão e o instalador o anexa 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 descritas na seção Como obter informações de contexto para ações personalizadas de execução adiada para recuperar o contexto.

As ações personalizadas que referenciam um arquivo instalado como sua respectiva origem, como o Tipo de Ação Personalizada 22 (VBcript), precisam 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.
  • Caso o arquivo de origem ainda não esteja 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