Tipo de ação personalizada 5

Essa ação personalizada é escrita em JScript, como ECMA 262. O Windows Installer não suporta JScript 1.0. Para obter mais informações, consulte Scripts.

Fonte

O script é gerado a partir de um fluxo binário temporário. O campo Origem da tabela CustomAction contém uma chave para a tabela Binary. A coluna Dados na tabela Binária contém os dados do fluxo. Um fluxo separado é alocado para cada linha.

Novos dados binários podem ser inseridos a partir de um arquivo usando MsiRecordSetStream seguido por 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 de acordo com o tipo de ação personalizada.

Valor do tipo

Inclua o seguinte valor na coluna Tipo da tabela CustomAction para especificar o tipo numérico básico de ação personalizada de 32 bits.

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.

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 de Session Object. O instalador anexa o objeto Session 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.

Quando uma tabela de banco de dados é exportada, cada fluxo é gravado como um arquivo separado na subpasta nomeada após a tabela, usando a chave primária como o nome do arquivo (coluna Nome para a tabela binária), com uma extensão padrão de ".ibd". O nome deve usar o formato de nome de arquivo 8.3 se o sistema de arquivos ou o sistema de controle de versão não suportar nomes de arquivo longos. O arquivo persistente substitui os dados de fluxo pelo nome de arquivo usado, para que os dados possam ser localizados quando a tabela for importada.

Tópicos relacionados

Custom_Actions