Instmsi.exe
Instmsi.exe é o pacote redistribuível para instalar o Windows Installer 2.0 e versões anteriores do Windows Installer. Consulte Redistribuíveis do Windows Installer para obter os redistribuíveis para o Windows Installer 3.0 e versões posteriores.
Para obter mais informações sobre qual versão do Windows Installer foi fornecida com seu sistema operacional, consulte versões lançadas do Windows Installer.
Alguns redistribuíveis não devem ser executados em determinadas versões do sistema operacional. A tabela a seguir descreve qual Instmsi é compatível em qual sistema operacional.
| Se Instmsi.exe instalar esta versão do Windows Installer | Instmsi.exe pode ser executado nestes sistemas operacionais | Instmsi.exe não deve ser executado nestes sistemas operativos |
|---|---|---|
| Windows Installer versão 1.0 | Windows 95, Windows 98, Windows NT 4.0+SP3 | Windows Me, Windows 2000, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 |
| Windows Installer versão 1.1 | Windows 95, Windows 98, Windows NT 4.0+SP3 | Windows Me, Windows 2000, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 |
| Windows Installer versão 1.2 | Windows 95, Windows 98, Windows Me, Windows NT 4.0+SP3 | Windows 2000, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 |
| Windows Installer versão 2.0 | Windows 95, Windows 98, Windows Me, Windows NT 4.0+SP6, Windows 2000 | Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 |
Por exemplo, um aplicativo que redistribui o Windows Installer versão 1.1 deve verificar se o sistema operacional é Windows NT 4.0 SP3 ou Windows 98/95 antes de executar o pacote redistribuível. Os aplicativos que usam o pacote redistribuível também devem garantir que a versão ANSI do Windows Installer esteja instalada no Windows 98/95 e que a versão Unicode esteja instalada no Windows NT ou Windows 2000. Observe que alguns aplicativos renomeiam a versão Unicode para InstMsiW.
Sintaxe
opções deinstmsi
Opções de linha de comando
As opções de linha de comando não diferenciam maiúsculas de minúsculas.
| Opção | Descrição |
|---|---|
| /q | Para uso por aplicativos que redistribuem o Windows Installer como parte de um aplicativo de inicialização. Nenhuma interface do usuário é apresentada ao usuário. O aplicativo de inicialização deve verificar o código de retorno para determinar se uma reinicialização é necessária para concluir a instalação do Windows Installer. |
| /t | Usado apenas para fins de depuração. |
| /c:"msiinst /delayreboot" | A opção de reinicialização atrasada. Impede que o Instmsi solicite uma reinicialização ao usuário, mesmo que ele tenha que substituir arquivos que estavam em uso durante a instalação. Se o Instmsi for invocado com essa opção, ele retornará ERROR_SUCCESS_REBOOT_REQUIRED se tivesse que substituir arquivos que estavam em uso. Se ele não tiver que substituir os arquivos que estavam em uso, ele retornará ERROR_SUCCESS. Disponível com o Instmsi para Windows Installer 2.0 ou posterior. Consulte a seção de comentários para obter informações adicionais sobre reinicializações atrasadas. |
| /c:"msiinst /delayrebootq" | A versão silenciosa da opção de reinicialização atrasada. Ele não apresenta nenhuma interface do usuário para o usuário. Caso contrário, o comportamento é idêntico à opção anterior. Disponível com o Instmsi para Windows Installer 2.0 ou posterior. Consulte a seção de comentários para obter informações adicionais sobre reinicializações atrasadas. |
| /? | Exibe ajuda. |
Comentários
Inicializar aplicativos que usam Instmsi.exe para instalar o Windows Installer com outro aplicativo pode exigir uma reinicialização extra do sistema. Esta é potencialmente uma reinicialização extra, além de quaisquer reinicializações que são necessárias para instalar o aplicativo.
A opção de reinicialização atrasada só é recomendada para desenvolvedores de instalação que desejam eliminar uma reinicialização extra causada pelo uso de Instmsi.exe com um aplicativo de instalação que instala arquivos que estão em uso.
Os desenvolvedores devem fazer o seguinte em seu aplicativo de configuração para usar a opção de reinicialização atrasada. Esta opção não está disponível com Instmsi.exe versões que instalam versões do Windows Installer anteriores à versão 2.0:
Para usar a opção de reinicialização atrasada
Chame Instmsi.exe com uma das opções de linha de comando de reinicialização atrasada.
Trate o retorno de ERROR_SUCCESS ou ERROR_SUCCESS_REBOOT_REQUIRED como significando sucesso.
Obtenha o caminho para a pasta que contém os binários do Windows Installer recém-instalados a partir do valor InstallerLocation em:
Software HKEY_LOCAL_MACHINE\\Microsoft\Windows\CurrentVersion\Installer
Este valor é do tipo REG_SZ.
Defina o diretório atual para o caminho obtido na etapa 3.
Invoque Msiexec no pacote do aplicativo e execute outro código de instalação específico para o aplicativo. Se o aplicativo de instalação usa MsiInstallProduct, então o aplicativo deve carregar MSI.DLL do local obtido na etapa 3.
Observação
Os aplicativos que chamam LoadLibrary no novo MSI.DLL no local obtido na etapa 3 devem garantir que uma versão mais antiga do MSI.DLL ainda não tenha sido carregada dentro do processo. Se uma versão mais antiga do MSI.DLL foi carregada dentro do processo, ela deve ser descarregada do espaço de endereço do processo antes da chamada LoadLibrary para o novo MSI.DLL.
Se a etapa (5) não exigir uma reinicialização e se Instmsi.exe tiver retornado ERROR_SUCCESS_REBOOT_REQUIRED na etapa (1), solicite ao usuário uma reinicialização para concluir a configuração dos binários do Windows Installer no sistema. No entanto, se ocorrer uma reinicialização na etapa (5), nenhuma etapa adicional será necessária.
Instmsi.exe está disponível no Windows SDK Components for Windows Installer Developers.
Tópicos relacionados