Compartilhar via


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 Windows Installer versão 4.0 ou posterior para instalação e manutenção usam automaticamente o do Gerenciador de Reinicialização do 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 Restart Manager. Para obter mais informações, consulte 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
de ação ForceReboot Solicita ao usuário uma reinicialização durante a instalação.
de ação ScheduleReboot Solicita ao usuário uma reinicialização no final da instalação.
de propriedade REBOOT Força ou suprime determinados prompts automáticos para uma reinicialização do sistema.
propriedade REBOOTPROMPT Suprime a exibição de prompts para 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.
de 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.
de diálogo FilesInUse Dá aos usuários a oportunidade de desligar processos para evitar algumas reinicializações do sistema.
de diálogo MsiRMFilesInUse Dá aos usuários a opção de usar o do Gerenciador de Reinicialização do para fechar e reiniciar aplicativos. Disponível a partir do Windows Installer versão 4.0.
propriedade ReplacedInUseFiles Defina se o instalador é instalado em um arquivo em uso. Essa propriedade é usada por ações personalizadas para detectar que uma reinicialização é necessária.
MSIRESTARTMANAGERCONTROL Propriedade para desabilitar a interação do Windows Installer com o do Gerenciador de Reinicialização do. Disponível a partir do Windows Installer versão 4.0.
MSIDISABLERMRESTART Especifica como o do Gerenciador de Reinicialização do fecha e reinicia os aplicativos. Disponível a partir do Windows Installer versão 4.0.
MSIRMSHUTDOWN Especifica como o do Gerenciador de Reinicialização do fecha e reinicia os aplicativos. Disponível a partir do Windows Installer versão 4.0.
MsiSystemRebootPending O instalador 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 do Gerenciador de Reinicialização do. 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 ocorrer antes que o código de erro seja retornado. Para obter mais informações, consulte códigos de erro.

Ações personalizadas podem forçar um prompt para reinicialização 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á o de diálogoFilesInUse.

Se você espera que o instalador exiba um FilesInUseDialog, mas não o faz, isso 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 mantém esses arquivos é o processo que invoca a instalação.
  • O processo que mantém esses arquivos é aquele que não tem uma janela com um título associado a ele.

Para obter mais informações, consulte registro em log de solicitações de reinicialização.