Compartilhar via


Objeto Installer

Um objeto Installer precisa ser criado inicialmente para carregar o suporte de automação necessário para que o COM acesse as funções do instalador. Esse objeto fornece wrappers para criar os objetos de nível superior e acessar os respectivos métodos.

Você pode criar o objeto Installer por meio da ProgId "WindowsInstaller.Installer".

Membros

O objeto Installer tem estes tipos de membros:

Métodos

O objeto Installer tem estes métodos.

Método Descrição
AddSource Adiciona uma fonte à lista de fontes de rede válidas na lista de fontes.
AdvertiseProduct Anuncia um pacote de instalação.
AdvertiseScript Anuncia um pacote de instalação.
ApplyMultiplePatches Aplica um ou mais patches aos produtos qualificados para receber o patch. Define a propriedade PATCH como o caminho dos pacotes de patch fornecidos.
ApplyPatch Invoca uma instalação e define a propriedade PATCH como o caminho do pacote de patch para cada produto listado pelo pacote de patch como qualificado para receber o patch.
ClearSourceList Remove todas as fontes de rede da lista de fontes.
CollectUserInfo Invoca uma sequência do assistente de interface do usuário que coleta e armazena as informações do usuário e o código do produto.
ConfigureFeature Configura o estado instalado de um recurso de produto.
ConfigureProduct Instala ou desinstala um produto.
CreateAdvertiseScript Gera um script de anúncio.
CreateRecord Retorna um novo objeto Record com o número solicitado de campos.
EnableLog Habilita o log do tipo de mensagem selecionado para todas as sessões de instalação seguintes no espaço de processo atual.
ExtractPatchXMLData Extrai informações de um patch como uma cadeia de caracteres XML.
FileHash Usa o caminho para um arquivo e retorna um hash de 128 bits desse arquivo.
FileSignatureInfo Usa o caminho para um arquivo e retorna uma SAFEARRAY de bytes que representa o hash ou o certificado codificado.
FileSize Retorna o tamanho do arquivo especificado.
FileVersion Retorna a cadeia de caracteres de versão ou a cadeia de caracteres de idioma do caminho especificado.
ForceSourceListResolution Força o instalador a procurar um produto válido na lista de fontes na próxima vez que uma fonte for necessária.
InstallProduct Abre um pacote do instalador e inicializa uma sessão de instalação.
LastErrorRecord Retorna um objeto Record que contém parâmetros de erro para o erro mais recente da função que produziu o registro de erro.
OpenDatabase Abre um banco de dados existente ou cria um.
OpenPackage Abre um pacote do instalador para uso com as funções que acessam o banco de dados do produto e instalam o mecanismo.
OpenProduct Abre um pacote do instalador para um produto instalado usando o código do produto.
ProvideAssembly Retorna o caminho instalado de um assembly.
ProvideComponent Retorna o caminho completo do componente e executa qualquer instalação necessária.
ProvideQualifiedComponent Retorna o caminho completo do componente e executa qualquer instalação necessária.
RegistryValue Lê as informações sobre uma chave de valor do Registro especificada.
ReinstallFeature Reinstala recursos ou corrige problemas com os recursos instalados.
ReinstallProduct Reinstala um produto ou corrige problemas de instalação em um produto instalado.
RemovePatches Remove um ou mais patches de produtos qualificados para receber o patch.
UseFeature Incrementa a contagem de uso de um recurso específico e retorna o estado de instalação desse recurso.

 

Propriedades

O objeto Installer tem estas propriedades.

Propriedade Tipo de acesso Descrição
ClientsEx
Retorna um objeto RecordList que lista os produtos que usam um componente instalado especificado.
Windows Installer 4.5 e versões anteriores: sem suporte.
ComponentClients
Retorna um objeto StringList que enumera o conjunto de clientes de um componente especificado.
ComponentPath
Retorna o caminho completo de um componente instalado.
ComponentPathEx
Retorna um objeto RecordList que fornece o caminho completo de um componente instalado especificado.
Windows Installer 4.5 e versões anteriores: sem suporte.
ComponentQualifiers
Retorna um objeto StringList que enumera o conjunto de qualificadores registrados para o componente especificado.
Componentes
Retorna um objeto StringList que enumera o conjunto de componentes instalados para todos os produtos.
ComponentsEx
Retorna um objeto RecordList que lista os componentes instalados.
Windows Installer 4.5 e versões anteriores: sem suporte.
Ambiente
Leitura/gravação
O valor de cadeia de caracteres para uma variável de ambiente do processo atual.
FeatureParent
Especifica o recurso pai de um recurso.
Recursos
Retorna um objeto StringList que enumera o conjunto de recursos publicados para o produto especificado.
FeatureState
Retorna o estado instalado de um recurso.
FeatureUsageCount
Retorna o número de vezes que o recurso foi usado.
FeatureUsageDate
Retorna a data em que o recurso especificado foi usado pela última vez.
FileAttributes
Retorna um número que representa os atributos de arquivo combinados para o caminho designado para um arquivo ou uma pasta.
Patches
Retorna um objeto StringList que contém todos os patches aplicados ao produto.
PatchesEx
Enumera uma coleção de objetos Patch.
PatchFiles
Retorna um objeto StringList que contém uma lista de arquivos que podem ser atualizados pela lista de patches fornecida.
PatchInfo
Retorna informações sobre um patch.
PatchTransforms
Retorna a lista delimitada por ponto e vírgula de transformações que estão no pacote de patch especificado e que foram aplicadas ao produto especificado.
ProductElevated
Retornará True se o produto for gerenciado ou False se o produto não for gerenciado.
ProductInfo
Retorna o valor do atributo especificado para um produto instalado ou publicado.
ProductInfoFromScript
Retorna o valor do atributo especificado armazenado em um script de anúncio.
Produtos
Retorna um objeto StringList que enumera o conjunto de todos os produtos instalados ou anunciados para o usuário e o computador atuais.
ProductsEx
Enumera uma coleção de objetos Product.
ProductState
Retorna as informações de estado de instalação de um produto.
QualifierDescription
Retorna uma cadeia de texto que descreve o componente qualificado.
RelatedProducts
Retorna um objeto StringList que enumera o conjunto de todos os produtos instalados ou anunciados para o usuário e o computador atuais com uma propriedade UpgradeCode especificada na tabela de propriedades.
ShortcutTarget
Examina um atalho e retorna o produto, o nome do recurso e o componente, se disponível.
SummaryInformation
Retorna um objeto SummaryInfo que pode ser usado para examinar, atualizar e adicionar propriedades ao fluxo de informações de resumo de um pacote ou de uma transformação.
UILevel
Leitura/gravação
Indica o tipo de interface do usuário a ser usado ao abrir e processar pacotes seguintes dentro do espaço de processo atual.
Versão
Retorna a representação de cadeia de caracteres da versão atual do Windows Installer.

 

Requisitos

Requisito Valor
Versão
Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
DLL
Msi.dll
IID
O IID_IInstaller é definido como 000C1090-0000-0000-C000-000000000046

Confira também

Como usar a Interface de automação

Exemplos de scripts do Windows Installer