Guia baseado em função para a documentação do Windows Installer

Artigo
06/13/2023

O Windows Installer é a solução recomendada para a instalação e configuração de aplicativos no Windows. Portanto, algumas das informações contidas nesse SDK serão de interesse para uma ampla gama de profissionais de TI e desenvolvimento de software. Esta seção é fornecida como um guia para leitores que preferem ver links para tópicos organizados por função profissional e cenários de tarefas comuns. Como as funções podem ser muito diferentes entre as organizações, o agrupamento a seguir só deve ser considerado como guia para um local para começar a pesquisar as informações necessárias.

Desenvolvedores de Aplicativos
Autores de Configuração
Profissionais de TI
Desenvolvedores de infraestrutura

Esta documentação é destinada a desenvolvedores de software que desejam criar aplicativos que usam o Windows Installer. Como a principal fonte de material de referência para o instalador, o SDK fornece informações sobre pacotes de instalação e o serviço do instalador. Contém descrições completas da API (interface de programação do aplicativo) e dos elementos do banco de dados do instalador.

Para obter mais informações, confira Outras fontes de informações do Windows Installer.

Desenvolvedores de Aplicativo

Os desenvolvedores de aplicativos criam aplicativos que chamam a interface de programação de aplicativos do Windows Installer e instalam pacotes do Windows Installer em tempo de execução. O Windows Installer pode trabalhar em um aplicativo, como reparo automático e instalação sob demanda. Normalmente, os desenvolvedores de aplicativos fazem o seguinte:

Habilite a instalação sob demanda de aplicativos em tempo de execução em outro aplicativo.

Para saber mais, consulte o seguinte:
Habilite o reparo automático de aplicativos reinstalando os componentes conforme necessário em tempo de execução.

Para saber mais, consulte o seguinte:
Exiba uma interface do usuário para coletar informações do usuário e preferências de configuração na primeira vez que um aplicativo for instalado ou executado. A interface do usuário deve ser adicionada pelo Autor de Configuração do pacote do Windows Installer.

Para saber mais, consulte o seguinte:
Crie aplicativos que usam um modelo de indireção para se referir a componentes com funcionalidade paralela. As categorias de componente qualificado devem ser adicionadas pelo Autor de Configuração do pacote do Windows Installer.

Para saber mais, consulte o seguinte:
- Componentes qualificados
- Como usar componentes qualificados
Use assemblies privados e lado a lado para isolar aplicativos e reduzir conflitos de DLL.

Para saber mais, consulte o seguinte:
Prepare o aplicativo para instalar suas próprias atualizações principais abrangentes.

Para saber mais, consulte o seguinte:
Prepare o aplicativo para instalar suas próprias atualizações secundárias, pequenas atualizações ou correções.

Para saber mais, consulte o seguinte:
Organize os recursos do aplicativo em componentes que podem funcionar com o Windows Installer.

Para saber mais, consulte o seguinte:

Autores de Configuração

Os Autores de Configuração criam pacotes do Windows Installer (arquivos .msi) que contêm a lógica de instalação e as informações necessárias para instalar um aplicativo. Normalmente, eles usam ferramentas de criação, como Orca.exe para preencher o banco de dados do Windows Installer com a lógica e as informações de configuração. Normalmente, os Autores de Configuração fazem o seguinte:

Determine a funcionalidade disponível com as diferentes versões do Windows Installer.

Para saber mais, consulte o seguinte:
- Como determinar a versão do Windows Installer
- Versões lançadas do Windows Installer
- Novidades do Windows Installer 5.0
Organize os recursos do aplicativo em componentes do Windows Installer.

Para saber mais, consulte o seguinte:
- Componentes do Windows Installer
- Como organizar aplicativos em componentes
- Como alterar o código do componente
- O que acontece se as regras do componente forem desrespeitadas?
- Exemplos do Windows Installer
Use ferramentas de criação de pacote do Windows Installer de terceiros ou ferramentas do SDK, como Orca.exe, para preencher um banco de dados de instalação e criar um pacote do Windows Installer.

Para saber mais, consulte o seguinte:
- Ferramentas de Desenvolvimento do Windows Installer
- Pacote de instalação, sobre o banco de dados do instalador
- Extensões de arquivo do Windows Installer
- Tabelas de banco de dados
- Códigos de pacote
- Como criar um pacote grande
- Windows Installer em sistemas operacionais de 64 bits
- Como nomear tabelas, propriedades e ações personalizadas
- Limitações de OLE em fluxos
- Formato de definição de coluna
- Como reduzir o tamanho de um arquivo .msi
Crie o banco de dados do Windows Installer para instalar arquivos.

Para saber mais, consulte o seguinte:
- Grupo de tabelas Core
- Grupo de tabelas File
- File Table
- Pesquisa de arquivo
- Avaliação de custo do arquivo
- Instalação de arquivo
- Arquivos complementares
- Regras de controle de versão de arquivo
- Controle de versão de arquivo padrão
- Como substituir arquivos existentes
- Como usar gabinetes e fontes compactadas
- Como remover arquivos isolados
- Como instalar componentes permanentes, arquivos, fontes e chaves do Registro
- Tabela FileSFPCatalog
- Como pesquisar um arquivo e criar uma propriedade que contém o caminho do arquivo
- Como pesquisar um diretório e um arquivo no diretório
- Exemplos do Windows Installer
Crie um banco de dados do Windows Installer que instale uma estrutura e pastas de diretório.

Para saber mais, consulte o seguinte:
- Grupo de tabelas Core
- Grupo de tabelas File
- Tabela Component
- Tabela Directory
- Como usar a tabela Directory
- Como usar uma propriedade de diretório em um caminho
- Propriedades de pasta do sistema
- Tabela CreateFolder
- Tabela LockPermissions
- Tabela MsiLockPermissionsEx
- Como alterar o local de destino de um diretório
- Exemplos do Windows Installer
Crie um banco de dados do Windows Installer que instale chaves do registro.

Para saber mais, consulte o seguinte:
- Grupo de tabelas Core
- Grupo de tabelas Registry
- Tabela Registry
- Como modificar o Registro
- Como adicionar ou remover chaves do registro durante a instalação ou a remoção de componentes
- Como adicionar e remover um aplicativo e não deixar nenhum rastreamento no Registro
- Como instalar componentes permanentes, arquivos, fontes e chaves do Registro
- Como pesquisar aplicativos, arquivos, entradas do Registro ou entradas de arquivo .ini existentes
- Como pesquisar uma entrada do Registro e criar uma propriedade que contém o valor do Registro
- Chaves do Registro de Assembly gravadas pelo Windows Installer
- Desinstalar chave do registro
- Tabela SelfReg
- Como especificar a ordem de autorregistro
- Exemplos do Windows Installer
Crie um banco de dados do Windows Installer que instale serviços.

Para saber mais, consulte o seguinte:
- Tabela ServiceInstall
- Tabela ServiceControl
- Tabela Component
Crie um banco de dados do Windows Installer que instale componentes isolados ou componentes COM.

Para saber mais, consulte o seguinte:
- Grupo de tabelas Registry
- Tabela Class
- Tabela Complus
- Componentes isolados
- Como usar componentes isolados
- Instalação de componentes isolados
- Reinstalação de componentes isolados
- Remoção de componentes isolados
- Como instalar um componente COM em um local privado
- Tornar um componente COM em um pacote existente privado
- Como instalar um aplicativo COM+ com o Windows Installer
- Como instalar um componente não COM em um local privado
- Tornar um componente não COM em um pacote existente privado
Crie um banco de dados do Windows Installer que instale assemblies.

Para saber mais, consulte o seguinte:
- Tabela MsiAssembly
- Tabela MsiAssemblyName
- Assemblies
- Chaves do Registro de Assembly gravadas pelo Windows Installer
- Instalação de assemblies Win32
Crie um banco de dados do Windows Installer que instale drivers ODBC e tradutores.

Para saber mais, consulte o seguinte:
- Tabela ODBCAttribute
- Tabela ODBCDriver
- Tabela ODBCTranslator
- Tabela ODBCDataSource
- Tabela ODBCSourceAttribute
Crie um banco de dados do Windows Installer que instale MIME.

Para saber mais, consulte o seguinte:
- Tabela MIME
- Tabela Extension
- Como modificar o Registro
Crie um banco de dados do Windows Installer que instale variáveis de ambiente.

Para saber mais, consulte o seguinte:
- Tabela Environment
Crie um banco de dados do Windows Installer que instale atalhos.

Para saber mais, consulte o seguinte:
- Tabela Shortcut
- Tabela MsiShortcutProperty
- Editar atalhos do instalador
- Exemplos do Windows Installer
Crie um banco de dados do Windows Installer que instale várias instâncias de aplicativos.

Para saber mais, consulte o seguinte:
- Como instalar várias instâncias de produtos e patches
- Como criar várias instâncias com transformações de instância
- Como instalar várias instâncias com transformações de instância
Especifique os estados e as opções de seleção de recursos padrão.

Para saber mais, consulte o seguinte:
- Grupo de tabelas Core
- Tabela Component
- Tabela Feature
- Tabela FeatureComponents
- Como controlar os estados de seleção de recursos
- Propriedades de opções de instalação de recursos
Especifique as condições que devem ser atendidas para instalar um aplicativo ou os componentes selecionados.

Para saber mais, consulte o seguinte:
- Tabela Condition
- Tabela LaunchCondition
- Tabela Component
- Como usar propriedades em instruções condicionais
- Sintaxe de instrução condicional
- Ações de condicionamento a serem executadas durante a remoção
- Exemplos de Sintaxe de Instrução Condicional
Crie a sequência de ações usadas para instalar o aplicativo.

Para saber mais, consulte o seguinte:
- Como usar a tabela Sequence
- Grupo de tabelas de procedimento de instalação
- Exemplo detalhado da tabela Sequence
- Ações com restrições de sequenciamento
- Ações sem restrições de sequenciamento
- Como usar propriedades em instruções condicionais
- Sintaxe de instrução condicional
- Exemplos de Sintaxe de Instrução Condicional
- Ações de condicionamento a serem executadas durante a remoção
- Ações padrão
- Exemplos do Windows Installer
Prepare o pacote de instalação do aplicativo para atualizações futuras do aplicativo pelo serviço Windows Installer.

Para saber mais, consulte o seguinte:
- Como aplicar patch e atualizações
- Preparar um aplicativo para futuras atualizações principais
- Como usar um UpgradeCode
- Tabela Upgrade
- Propriedade UpgradeCode
- Como impedir que um pacote antigo seja instalado em uma versão mais recente
- Como alterar o código do produto
- Atualizando assemblies
- Exemplos do Windows Installer
Solucione problemas de pacotes do Windows Installer em desenvolvimento.

Para saber mais, consulte o seguinte:
- Validação de pacotes
- ICEs – Avaliadores Internos de Consistência
- Registro em log do Windows Installer
- Como verificar a instalação de recursos, componentes e arquivos
- Como criar um pacote grande
- Wilogutl.exe
- Ferramentas de Desenvolvimento do Windows Installer
- Como validar de módulos de mesclagem
- Como validar um banco de dados de instalação
- Como validar uma atualização de instalação
- Como pesquisar um recurso ou um componente desfeito
- Mensagens de erro do Windows Installer
- Log de solicitações de reinicialização
Garanta uma configuração e instalação seguras do aplicativo.

Para saber mais, consulte o seguinte:
- Diretrizes para criação de instalações seguras
- Diretrizes para proteger ações personalizadas
- Segurança da ação personalizada
- Diretrizes para proteger pacotes em computadores bloqueados
- Como criar uma instalação assinada totalmente verificada usando automação
- Um exemplo de instalação do Windows Installer baseado em URL
- Como criar a interface do usuário para entrada de senha
- Assinaturas digitais e Windows Installer
- Como usar o Windows Installer com o UAC
- Aplicação de patch de UAC (Controle de Conta de Usuário)
- Msicert.exe
- Propriedade AdminUser
- Propriedade Privileged
- Propriedade SecureCustomProperties
Crie uma interface do usuário para apresentar opções para configurar a instalação e obter informações do usuário sobre o processo de instalação pendente.

Para saber mais, consulte o seguinte:
- Sobre a interface do usuário
- Como adicionar controles e texto
- Como criar um Controle ProgressBar
- Como criar mensagens de prompt de disco
- Como criar uma caixa de mensagem condicional . . "Aguarde..."
- Como visualizar a interface do usuário
- Como adicionar um texto armazenado em uma propriedade
- MsiSetInternalUI
Crie uma interface do usuário externa para apresentar uma interface do usuário personalizada para configurar a instalação e obter informações do usuário sobre o processo de instalação pendente.

Para saber mais, consulte o seguinte:
- MsiSetExternalUI
- Como monitorar uma instalação usando MsiSetExternalUIRecord
- Como analisar mensagens do Windows Installer
- Como retornar valores de um manipulador de interface do usuário externa
- INSTALLUI_HANDLER
- Como manipular mensagens de progresso usando MsiSetExternalUI
- Como monitorar uma instalação usando MsiSetExternalUI
Definir informações para o aplicativo em Adicionar/Remover Programas (ARP.)

Para saber mais, consulte o seguinte:
- Como configurar Adicionar/Remover Programas com o Windows Installer
- Como adicionar e remover um aplicativo e não deixar nenhum rastreamento no Registro
- Desinstalar chave do registro
Grave ações personalizadas para lidar com a lógica de configuração que não tem suporte nativo do Windows Installer.

Para saber mais, consulte o seguinte:
- Ações personalizadas
- Lista de resumo de todos os tipos de ação personalizada
- Diretrizes para proteger ações personalizadas
- Referência de ações personalizadas
- Como usar uma ação personalizada para criar contas de usuário em um computador local
- Como usar uma ação personalizada para iniciar um arquivo instalado no final da instalação
- Como acessar um banco de dados ou uma sessão em uma ação personalizada
- Como acessar a sessão do instalador atual em uma ação personalizada
- Como alterar o estado do sistema usando uma ação personalizada
Inicialize o Windows Installer no computador de um usuário.

Para saber mais, consulte o seguinte:
- Inicialização
- Instmsi.exe
- Inicialização de download da Internet
- Msistuff.exe
- Um exemplo de instalação do Windows Installer baseado em URL
- Como configurar os recursos de Setup.exe
- Como baixar uma instalação da Internet
Siga as diretrizes de Acessibilidade Ativa ao gravar os pacotes do Windows Installer.

Para saber mais, consulte o seguinte:
- Acessibilidade
Prepare-se para a internacionalização de uma configuração de aplicativo.

Para saber mais, consulte o seguinte:
- Como preparar um pacote do Windows Installer para localização
- Localizar um pacote do Windows Installer
- Tratamento da página de códigos (Windows Installer)
- Como adicionar recursos localizados
- Um exemplo de localização
- Como localizar as tabelas Error e ActionText
- Como localizar colunas de banco de dados
- Como criar um banco de dados com uma página de código neutra
- Tratamento da página de código de tabelas importadas e exportadas
- Como localizar o idioma exibido por caixas de diálogo
- Como importar as tabelas Error e ActionText localizadas
- Como atualizar as propriedades ProductLanguage e ProductCode
- Como atualizar um fluxo de informações de resumo
- Componentes qualificados
- Tabela UIText
- Gerenciar idioma e página de código
- Como verificar a página de código do banco de dados de instalação
Crie os pacotes do Windows Installer para plataformas de 32 bits e 64 bits.

Para saber mais, consulte o seguinte:
- Windows Installer em sistemas operacionais de 64 bits
- Ações personalizadas de 64 bits
- Como usar ações personalizadas de 64 bits
- Uso de módulos de mesclagem de 64 bits
Redistribua componentes compartilhados do Windows Installer e a lógica de configuração como módulos de mesclagem.

Para saber mais, consulte o seguinte:
- Módulos de mesclagem
- Como criar uma transformação de idioma para um módulo de mesclagem de vários idiomas
- Como aplicar um módulo de mesclagem configurável com personalizações
Agende ou suprima reinicializações durante uma instalação do Windows Installer.

Para saber mais, consulte o seguinte:
- Reinicializações do sistema
- Log de solicitações de reinicialização
Crie atualizações ou correções para um aplicativo existente criando um patch.

Para saber mais, consulte o seguinte:
- Como criar um patch de atualização pequena
- Um exemplo de aplicação de patch em uma pequena atualização
Crie um pacote de uso duplo capaz de instalar um aplicativo somente para o usuário atual ou para todos os usuários do computador.

Para saber mais, consulte o seguinte:
- Contexto de instalação
- Criação de pacote único
- Exemplo de criação de pacote único
Personalize os serviços no computador usando o Windows Installer.

Para saber mais, consulte o seguinte:
- Como usar configuração de serviços
Proteja os recursos no computador usando o Windows Installer.

Para saber mais, consulte o seguinte:
- Diretrizes para criação de instalações seguras
- Como proteger os recursos
Enumere todos os componentes instalados no computador e obtenha o caminho da chave para o componente.

Para saber mais, consulte o seguinte:
- Como enumerar componentes
Instale vários pacotes usando o processamento de transações.

Para saber mais, consulte o seguinte:
- Instalações de vários pacotes
Insira uma interface do usuário personalizada no pacote do Windows Installer.

Para saber mais, consulte o seguinte:
- Usando a interface do usuário
- Como usar uma interface do usuário inserida

Profissionais de TI

Os Profissionais de TI e Administradores personalizam e implantam os pacotes existentes do Windows Installer. Esses usuários reempacotam as configurações dos aplicativos existentes nos pacotes de instalação do Windows Installer e instalam e mantêm as imagens administrativas de instalações do Windows Installer nas redes.

Personalizar aplicativos e configuração gerando e aplicando transformações do Windows Installer

Para saber mais, consulte o seguinte:
Implante um pacote de instalação, atualização ou patch do Windows Installer.

Para saber mais, consulte o seguinte:
Solucionar problemas de pacotes do Windows Installer.

Para saber mais, consulte o seguinte:
Use scripts para consultar pacotes do Windows Installer para obter informações sobre um produto e modificar a instalação.

Para saber mais, consulte o seguinte:
Crie e mantenha as instalações administrativas.

Para saber mais, consulte o seguinte:
Disponibilize um aplicativo para todos os usuários de um computador ou apenas para um usuário especificado.

Para saber mais, consulte o seguinte:
- Contexto de instalação
- Propriedade ALLUSERS
Interpretar pacotes, instalar produtos e configurar opções de recursos usando uma linha de comando.

Para saber mais, consulte o seguinte:
Trabalhe com a política para gerenciar direitos de acesso e permissões.

Para saber mais, consulte o seguinte:
Instale vários pacotes usando o processamento de transações.

Para saber mais, consulte o seguinte:
- Instalações de vários pacotes
Insira uma interface do usuário personalizada em um pacote do Windows Installer.

Para saber mais, consulte o seguinte:
- Usando a interface do usuário
- Como usar uma interface do usuário inserida

Desenvolvedores de infraestrutura

Os desenvolvedores de infraestrutura podem criar plataformas unificadas para a implantação e o gerenciamento de software que usa o serviço Windows Installer. Eles podem usar a interface de programação do Windows Installer para consultar, gerenciar e distribuir aplicativos, patches e fontes em um sistema.

Localize, inventarie e consulte o estado, informações e clientes de componentes.

Para saber mais, consulte o seguinte:
Inventarie e consulte informações e o estado de produtos e recursos.

Para saber mais, consulte o seguinte:
Melhore a resiliência do código-fonte usando o Windows Installer para inventariar, consultar e modificar a lista de origem de aplicativos, atualizações e patches.

Para saber mais, consulte o seguinte:
Melhore a resiliência do código-fonte usando o Windows Installer para inventariar, consultar e modificar fontes de mídia.

Para saber mais, consulte o seguinte:
Inventarie e consulte informações e o estado de patches.

Para saber mais, consulte o seguinte:
Trabalhe com a política para gerenciar direitos de acesso e permissões.

Para saber mais, consulte o seguinte:

Compartilhar via