Ação Personalizada Tipo 39
A Ação Personalizada Tipo 39 é usada com instalações simultâneas. Instalações simultâneas não são recomendadas para instalar aplicativos destinados a serem liberados para o público. Para obter informações sobre instalações simultâneas, confira Instalações simultâneas.
A ação personalizada Tipo 39 instala um aplicativo anunciado ou já instalado. Esse tipo de ação personalizada pode ser usado para reinstalar ou remover um produto que foi instalado como instalação simultânea pelo pacote de instalação do produto atual. A ação personalizada Tipo 39 não pode ser usada para reinstalar ou remover produtos instalados anteriormente por outros meios. Por exemplo, se o produto secundário foi instalado usando uma ação personalizada Tipo 39, Tipo 23 ou Tipo 7 durante a instalação do produto primário, uma ação personalizada Tipo 39 poderá ser usada para remover o produto secundário quando o produto primário for desinstalado.
Fonte
O campo Source da tabela CustomAction contém o código do produto para o aplicativo.
Tipo numérico
| Nome do tipo | Valor |
|---|---|
| msidbCustomActionTypeInstall + msidbCustomActionTypeDirectory | 39 |
Destino
O campo Target da tabela CustomAction contém configurações de propriedade que devem ser transmitidas para a instalação simultânea. Essas configurações de propriedade podem especificar recursos.
Opções de processamento de retorno
A ação personalizada tipo 39 falhará se o aplicativo não for anunciado ou instalado. Para evitar essa falha, você deve definir o msidbCustomActionTypeContinueflag.
Uma instalação simultânea não pode ser executada de maneira assíncrona.
Confira Opções de processamento de retorno da ação personalizada.
Opções de Agendamento de Execução
Os sinalizadores de opções estão disponíveis para controlar a possível execução múltipla de ações personalizadas. Confira Opções de agendamento de execução de ação personalizada.
Opções de Execução no Script
A ação personalizada não usa essa opção.
Valores de retorno
O status de retorno da saída do usuário, falha, suspensão ou êxito de uma instalação simultânea é processado da mesma forma que qualquer outra ação. No entanto, observe que o Windows Installer converte os valores retornados de todas as ações ao gravar o valor retornado no arquivo de log. Por exemplo, se o valor retornado da ação for exibido como 1 no arquivo de log, isso significará que a ação retornou ERROR_SUCCESS. Para obter mais informações, confira Log de valores retornados da ação.
Observe que, se uma instalação simultânea tiver msidbCustomActionTypeContinue definido, um retorno de ERROR_INSTALL_USEREXIT, ERROR_INSTALL_REBOOT, ERROR_INSTALL_REBOOT_NOW ou ERROR_SUCCESS_REBOOT_REQUIRED será tratado como ERROR_SUCCESS. Isso significa que, se você definir msidbCustomActionTypeContinue e sua instalação simultânea exigir uma reinicialização, o requisito para a reinicialização será ignorado. Além disso, o código de erro da ação personalizada de instalação simultânea será ignorado.
Se msidbCustomActionTypeContinue não for definido, os códigos de retorno a seguir mais ERROR_SUCCESS serão tratados como sucesso e terão os significados abaixo. Outros códigos de retorno são tratados como uma falha.
| Mensagem | Significado |
|---|---|
| ERROR_INSTALL_REBOOT | O sinalizador de reinicialização será definido para ser reiniciado no final da instalação. |
| ERROR_INSTALL_REBOOT_NOW | Uma reinicialização é necessária antes da conclusão da instalação. A reinicialização será processada imediatamente. |
| ERROR_SUCCESS_REBOOT_REQUIRED | Uma reinicialização foi necessária, mas foi suprimida. |
Comentários
Uma expressão condicional é necessária para habilitar a instalação simultânea na instalação ou na remoção do componente ou do recurso associado.
Tópicos relacionados