Reinicializações do sistema
O Windows Installer pode determinar quando uma reinicialização do sistema é necessária e solicitar automaticamente que o usuário reinicialize no final da instalação. Por exemplo, o instalador solicitará automaticamente uma reinicialização se precisar substituir os arquivos que estiverem em uso durante a instalação.
Aplicativos que usam o Windows Installer versão 4.0 ou posterior para instalação e manutenção usam automaticamente o Gerenciador de Reinicialização para reduzir as reinicializações do sistema. O Windows Installer versão 4.0 ou posterior tem propriedades e políticas que permitem que o autor do pacote e os administradores controlem a interação do Windows Installer com o Gerenciador de Reinicialização. Para obter mais informações, confira Usando o Windows Installer com o Restart Manager.
Os autores do pacote de instalação podem agendar e suprimir reinicializações usando ações padrão nas tabelas de sequência e definindo propriedades. As ações e as propriedades a seguir são usadas para lidar com reinicializações do sistema.
| Ação, caixa de diálogo ou propriedade | Breve descrição |
|---|---|
| Ação ForceReboot | Solicita ao usuário uma reinicialização durante a instalação. |
| Ação ScheduleReboot | Solicita ao usuário uma reinicialização no final da instalação. |
| Propriedade REBOOT | Força ou suprime determinadas solicitações automáticas para uma reinicialização do sistema. |
| Propriedade REBOOTPROMPT | Suprime a exibição de prompts de reinicializações para o usuário. Todas as reinicializações necessárias ocorrem automaticamente. |
| Propriedade AFTERREBOOT | Normalmente usado em uma condição imposta à Ação ForceReboot. |
| Ação InstallValidate | Exibe a caixa de diálogo FilesInUse, se necessário, dando aos usuários a oportunidade de desligar processos e evitar algumas reinicializações do sistema. |
| Caixa de diálogo FilesInUse | Dá aos usuários a oportunidade de desligar processos para evitar algumas reinicializações do sistema. |
| Caixa de diálogo MsiRMFilesInUse | Dá aos usuários a opção de usar o Gerenciador de Reinicialização para fechar e reiniciar aplicativos. Disponível a partir do Windows Installer versão 4.0. |
| Propriedade ReplacedInUseFiles | Defina se o instalador for instalado em um arquivo em uso. Essa propriedade é usada por ações personalizadas para detectar se uma reinicialização é necessária. |
| MSIRESTARTMANAGERCONTROL | Propriedade para desabilitar a interação do Windows Installer com o Gerenciador de Reinicialização. Disponível a partir do Windows Installer versão 4.0. |
| MSIDISABLERMRESTART | Especifica como o Gerenciador de Reinicialização fecha e reinicia os aplicativos. Disponível a partir do Windows Installer versão 4.0. |
| MSIRMSHUTDOWN | Especifica como o Gerenciador de Reinicialização fecha e reinicia os aplicativos. Disponível a partir do Windows Installer versão 4.0. |
| MsiSystemRebootPending | O Installer define essa propriedade se uma reinicialização do sistema operacional estiver pendente. Disponível a partir do Windows Installer versão 4.0. |
| DisableAutomaticApplicationShutdown | Política para desabilitar a interação do Windows Installer com o Gerenciador de Reinicialização. Disponível a partir do Windows Installer versão 4.0. |
ERROR_INSTALL_SUSPEND significa que a instalação não foi concluída ou revertida. A instalação deve ser retomada antes de ser concluída. O sistema pode precisar ser reinicializado antes que a instalação possa ser retomada.
O Windows Installer retorna o código de erro ERROR_INSTALL_SUSPEND quando a ação ForceReboot é executada. Ele retornará ERROR_SUCCESS_REBOOT_REQUIRED se uma reinicialização for necessária antes de executar o aplicativo e retornará ERROR_SUCCESS_REBOOT_INITIATED se o instalador realmente tiver iniciado uma reinicialização. Observe que, como as reinicializações são assíncronas, a reinicialização pode realmente ocorrer antes que o código de erro seja retornado. Para obter mais informações, veja os Códigos de Erro.
Ações personalizadas podem forçar a reinicialização de um prompt no final de uma instalação chamando MsiSetMode. As ações personalizadas também podem verificar se há um prompt de reinicialização pendente chamando MsiGetMode.
Caixa de diálogo FilesInUse
O instalador pode determinar quando uma reinicialização do sistema é necessária e solicitar ao usuário uma solicitação de reinicialização. Normalmente, uma reinicialização do sistema é necessária porque o instalador está tentando instalar um arquivo que está sendo usado no momento. Se a ação InstallValidate detectar a instalação de um arquivo em uso, ela exibirá a Caixa de diálogo FilesInUse.
Se você espera que o instalador exiba um FilesInUseDialog, mas isso não acontecer, pode ser devido a um dos seguintes motivos:
- Os arquivos em uso não são executáveis.
- O instalador não está realmente tentando instalar esses arquivos.
- O processo que contém esses arquivos é o processo que invoca a instalação.
- O processo que contém esses arquivos é aquele que não tem uma janela com um título associado a ele.
Para obter mais informações, confira Registro em log de solicitações de reinicialização.