Usando o Gerenciador de Reinicialização

  • Artigo

As seções a seguir descrevem o uso da API do Gerenciador de Reinicialização. Seus aplicativos e serviços também devem seguir as Diretrizes para Aplicativos e Serviços.

Usando o Microsoft Windows Installer

O Microsoft Windows Installer Versão 4.0 é o serviço de instalação de aplicativos do Windows Vista ou do Windows Server 2008. Os aplicativos que usam o Windows Installer versão 4.0 para instalação e manutenção usam automaticamente o Gerenciador de Reinicialização para reduzir as reinicializações do sistema. Os instaladores personalizados também podem ser projetados para chamar a API do Restart Manager para desligar e reiniciar aplicativos e serviços diretamente para evitar a necessidade de uma reinicialização do sistema. Nos casos em que uma reinicialização do sistema é inevitável, os instaladores podem usar a função InitiateShutdown ou ExitWindowsEx para agendá-la de forma a minimizar a interrupção para o usuário. Os pacotes interativos do Windows Installer devem implementar uma interface do usuário que inclua uma caixa de diálogo MsiRMFilesInUse . Para obter mais informações, consulte Usando o Windows Installer com o Restart Manager na documentação do SDK do Windows Installer.

Usando a API do Gerenciador de Reinicialização com instaladores personalizados

Os instaladores personalizados ou um pacote do Windows Installer que contém ações personalizadas que causam uma reinicialização do sistema podem usar a API do Gerenciador de Reinicialização para desligar e reiniciar aplicativos e serviços.

  • Todas as operações executadas usando a API do Restart Manager devem ser associadas a uma sessão. No máximo, 64 sessões do Gerenciador de Reinicialização por sessão de usuário podem ser abertas no sistema ao mesmo tempo. O instalador primário inicia e encerra a sessão do Gerenciador de Reinicialização. Para obter mais informações sobre como usar o Gerenciador de Reinicialização com um único instalador, consulte Usando o Gerenciador de Reinicialização com um Instalador Primário.
  • Se necessário para a instalação, um ou mais instaladores secundários podem ser ingressados na sessão do Gerenciador de Reinicialização e podem ser executados em processo ou fora do processo do instalador primário. Os instaladores secundários exigem que a chave de sessão seja fornecida pelo instalador primário para ingressar em uma sessão. Para obter mais informações e um exemplo de como usar instaladores secundários, consulte Usando o Gerenciador de Reinicialização com um Instalador Secundário.
  • Os instaladores interativos devem implementar uma interface do usuário que inclua uma caixa de diálogo MsiRMFilesInUse que possa solicitar que os usuários fechem aplicativos e serviços. Para obter mais informações, consulte Usando o Windows Installer com o Restart Manager na documentação do SDK do Windows Installer.
  • Os instaladores podem chamar a API do Gerenciador de Reinicialização para alterar, cancelar e obter o status da operação atual do Restart Manager. Para obter mais informações, consulte os seguintes tópicos: Obtendo o status de uma operação do Restart Manager e cancelando a operação do Gerenciador de Reinicialização Atual.
  • Os instaladores não devem desabilitar o redirecionamento do sistema de arquivos antes de chamar a API do Gerenciador de Reinicialização. Alguns instaladores de 32 bits executados no Windows de 64 bits podem não conseguir registrar um arquivo no diretório %windir%\system32.