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 |
|
| IID |
O IID_IInstaller é definido como 000C1090-0000-0000-C000-000000000046 |
Confira também