Referência da função do instalador
Para habilitar o Windows Installer em seu aplicativo, você deve usar as funções do instalador. As tabelas neste tópico identificam as funções por categoria.
Interface do usuário e funções de registro em log
| Designação | Descrição |
|---|---|
| MsiSetInternalUI | Habilita a interface de usuário interna do instalador. |
| MsiSetExternalUI | Permite um manipulador de interface do usuário externo que recebe mensagens em um formato de cadeia de caracteres. |
| MsiSetExternalUIRecord | Permite um manipulador de interface do usuário externo que recebe mensagens em um formato de registro. |
| MsiEnableLog | Define o modo de log para todas as instalações no processo de chamada. |
Lidar com funções de gerenciamento
| Designação | Descrição |
|---|---|
| MsiCloseHandle | Fecha uma alça de instalação aberta. |
| MsiCloseAllHandles | Fecha todas as alças de instalação abertas. Não utilizar para limpeza. |
Funções de instalação e configuração
| Designação | Descrição |
|---|---|
| MsiAdvertiseProduct | Anuncia um produto. |
| MsiAdvertiseProductEx | Anuncia um produto. |
| MsiAdvertiseScript | Copia um arquivo de script de anúncio em locais especificados. |
| MsiInstallProduct | Instala ou remove um aplicativo ou pacote de aplicativos. |
| MsiConfigureProduct | Instala ou remove um aplicativo ou pacote de aplicativos. |
| MsiConfigureProductEx | Instala ou remove um aplicativo ou pacote de aplicativos. Uma linha de comando do produto pode ser especificada. |
| MsiReinstallProduct | Reinstala ou repara uma instalação. |
| MsiConfigureFeature | Configura o estado instalado de um recurso. |
| MsiReinstallFeature | Valida ou repara recursos. |
| MsiInstallMissingComponent | Instala componentes ausentes. |
| MsiInstallMissingFile | Instala ficheiros em falta. |
| MsiNotifySidChange | Notifica e atualiza as informações internas do Windows Installer com alterações nos SIDs do usuário. Disponível a partir do Windows Installer 3.1. |
| MsiProcessAdvertiseScript | Processa um arquivo de script de anúncio em locais especificados. |
| MsiSourceListAddSource | Adiciona ou reordena as fontes de um patch ou produto em um contexto especificado. |
| MsiSourceListAddSourceEx | Adiciona ou reordena as fontes de um patch ou produto em um contexto especificado. Cria uma lista de fontes para um patch que não existe em um contexto especificado. Disponível no Windows Installer 3.0. |
| MsiSourceListClearSource | Remove uma fonte existente para um produto ou patch em um contexto especificado. Disponível no Windows Installer 3.0. |
| MsiSourceListClearAll | Remove todas as fontes existentes de um tipo de fonte específico para uma instância de produto especificada. |
| MsiSourceListClearAllEx | Remove todas as fontes existentes de um tipo de fonte específico para uma instância de produto especificada. Disponível no Windows Installer 3.0. |
| MsiSourceListForceResolution | Remove o registro da fonte atual do produto ou patch, que está registrado como a propriedade "LastUsedSource". Esta função não afeta a lista de fontes registradas. |
| MsiSourceListForceResolutionEx | Remove o registro da fonte atual do produto ou patch, que está registrado como a propriedade "LastUsedSource". Esta função não afeta a lista de fontes registradas. Disponível no Windows Installer 3.0. |
| MsiSourceListGetInfo | Recupera informações sobre a lista de fontes de um produto ou patch em um contexto específico. |
| MsiSourceListSetInfo | Define a fonte usada mais recentemente para um produto ou patch em um contexto especificado. Disponível no Windows Installer 3.0. |
| MsiSourceListEnumMediaDisks | Enumera a lista de discos registrados para a fonte de mídia de um patch ou produto. Disponível no Windows Installer 3.0. |
| MsiSourceListAddMediaDisk | Adiciona ou atualiza um disco da fonte de mídia de um produto ou patch registrado. Disponível no Windows Installer 3.0. |
| MsiSourceListClearMediaDisk | Remove um disco registrado existente sob a fonte de mídia de um produto ou patch em um contexto específico. Disponível no Windows Installer 3.0. |
| MsiSourceListEnumSources | Enumera as fontes na lista de fontes de um patch ou produto especificado. Disponível no Windows Installer 3.0. |
Component-Specific Funções
| Designação | Descrição |
|---|---|
| MsiProvideAssembly | Instala e retorna o caminho completo do componente para um assembly. |
| MsiProvideComponent | Instala e retorna o caminho completo do componente de um componente. |
| MsiProvideQualifiedComponent | Instala e retorna o caminho completo do componente de um componente qualificado. |
| MsiProvideQualifiedComponentEx | Instala e retorna o caminho completo do componente de um componente qualificado que é publicado por um produto. |
| MsiGetComponentPath | Retorna o caminho completo ou a chave do Registro para um componente instalado. |
| MsiGetComponentPathEx | Retorna o caminho completo ou a chave do Registro para um componente instalado em contas de usuário e contexto de instalação.
Windows Installer 4.5 e versões anteriores: Não suportado. |
| MsiLocateComponent | Retorna o caminho completo para um componente instalado sem um código de produto. |
| MsiQueryComponentState | Retorna o estado instalado de um componente. Pode consultar componentes de uma instância de um produto instalado em contas de usuário diferentes do usuário atual. Disponível no Windows Installer 3.0 ou posterior. |
Application-Only Funções
| Designação | Descrição |
|---|---|
| MsiCollectUserInfo | Armazena informações do usuário de um assistente de instalação. |
| MsiUseFeature | Incrementa a contagem de uso de um recurso e indica o estado da instalação. |
| MsiUseFeatureEx | Incrementa a contagem de uso de um recurso e indica o estado da instalação. |
| MsiGetProductCode | Retorna o código do produto usando o código do componente. |
Funções de status do sistema
| Designação | Descrição |
|---|---|
| MsiEnumProdutos | Enumera os produtos anunciados. |
| MsiEnumProductsEx | Enumera todas as instâncias de produtos anunciados ou instalados em um contexto especificado. Disponível no Windows Installer 3.0 ou posterior. |
| MsiEnumProdutos relacionados | Enumera os produtos atualmente instalados com um código de atualização especificado. |
| MsiEnumCaracterísticas | Enumera os recursos publicados. |
| MsiEnumComponents | Enumera os componentes instalados. |
| MsiEnumComponentsEx | Enumera os componentes instalados em contas de usuário e contexto de instalação.
Windows Installer 4.5 e versões anteriores: Não suportado. |
| MsiEnumClientes | Enumera os clientes de um componente instalado. |
| MsiEnumClientsEx | Enumera os clientes de um componente instalado em contas de usuário e contexto de instalação.
Windows Installer 4.5 e versões anteriores: Não suportado. |
| MsiEnumComponentQualifiers | Enumera os qualificadores anunciados para um componente. |
| MsiQueryFeatureState | Retorna o estado instalado de um recurso. |
| MsiQueryFeatureStateEx | Retorna o estado instalado de um recurso do produto. Pode consultar recursos de uma instância de um produto instalado em contas de usuário diferentes do usuário atual. Disponível no Windows Installer 3.0 ou posterior. |
| MsiQueryProductState | Retorna o estado instalado de um aplicativo ou pacote de aplicativos. |
| MsiGetFeatureUsage | Retorna métricas de uso para um recurso. |
| MsiGetProductInfo | Retorna informações sobre produtos publicados e instalados. |
| MsiGetProductInfoEx | Retorna informações sobre produtos anunciados e instalados. Pode recuperar informações sobre uma instância de um produto instalado em uma conta de usuário diferente do usuário atual. Disponível no Windows Installer 3.0 ou posterior. |
| MsiGetUserInfo | Retorna informações de usuário registrado para um produto instalado. |
Funções de consulta de produto
| Designação | Descrição |
|---|---|
| MsiOpenProduct | Abre um produto para usar com as funções que acessam o banco de dados. |
| MsiOpenPackage | Abre um pacote para usar com as funções que acessam o banco de dados. |
| MsiOpenPackageEx | Abre um pacote para usar com as funções que acessam o banco de dados. |
| MsiIsProductElevated | Verifica se o produto está instalado com privilégios elevados. |
| MsiGetProductInfoFromScript | Retorna informações do produto para um arquivo de script do instalador. |
| MsiGetProductProperty | Recupera propriedades no banco de dados do produto. |
| MsiGetShortcutTarget | Examina um atalho e retorna seu produto, nome do recurso e componente, se disponível. |
| MsiGetFeatureInfo | Retorna informações descritivas para um recurso. |
| MsiVerifyPackage | Verifica se um arquivo especificado é um pacote de instalação. |
Funções de aplicação de patches
| Designação | Descrição |
|---|---|
| MsiApplyPatch | Invoca uma instalação e aplica um pacote de patch. |
| MsiEnumPatches | Retorna o GUID de cada patch aplicado a um produto e uma lista de transformações de cada patch que se aplicam ao produto. |
| MsiGetPatchInfo | Retorna informações sobre um patch. |
| MsiRemovePatches | Desinstala um patch de um produto. Disponível no Windows Installer 3.0. |
| MsiDeterminePatchSequence | Determina a melhor sequência de aplicação para um conjunto de patches e produtos. Disponível no Windows Installer 3.0. |
| MsiApplyMultiplePatches | Aplica um ou mais patches aos produtos. Disponível no Windows Installer 3.0. |
| MsiEnumPatchesEx | Enumera todos os patches aplicados a um produto em um contexto específico ou em todos os contextos. Disponível no Windows Installer 3.0. |
| MsiGetPatchFileList | Quando fornecida uma lista de arquivos .msp, esta função recupera a lista de arquivos que podem ser atualizados pelos patches para o targe. Disponível no Windows Installer 4.0. |
| MsiGetPatchInfoEx | Consultas para obter informações sobre a aplicação de um patch especificado a um produto especificado. Disponível no Windows Installer 3.0. |
| MsiExtractPatchXMLData | Extrai informações de um patch. Disponível no Windows Installer 3.0. |
| MsiDetermineApplicablePatches | Determina o melhor conjunto de patches necessários para atualizar um produto ou conjunto de produtos. Disponível no Windows Installer 3.0. |
Funções de consulta de arquivo
| Designação | Descrição |
|---|---|
| MsiGetFileHash | Leva o caminho para um arquivo e retorna um hash de 128 bits desse arquivo. |
| MsiGetFileSignatureInformation | Usa o caminho para um arquivo que foi assinado digitalmente e retorna o certificado e o hash do signatário do arquivo. |
| MsiGetFileVersion | Retorna a cadeia de caracteres de versão e a cadeia de caracteres de idioma. |
Funções de gerenciamento de transações
| Designação | Descrição |
|---|---|
| MsiBeginTransaction | Inicia o processamento de transações de uma instalação de vários pacotes e retorna um identificador para a transação. Esta função está disponível a partir do Windows Installer 4.5. |
| MsiJoinTransaction | Solicita que o Windows Installer torne o processo atual o proprietário da transação instalando uma instalação de vários pacotes. Esta função está disponível a partir do Windows Installer 4.5. |
| MsiEndTransaction | Confirma ou reverte todas as instalações pertencentes à transação. Esta função está disponível a partir do Windows Installer 4.5. |
Funções do banco de dados
Além das funções do Windows Installer identificadas nas tabelas anteriores, você pode manipular informações no banco de dados de instalação usando as funções de acesso ao banco de dados descritas na seção Funções de Banco de Dados.
Estruturas Instaladoras
Além disso, algumas informações no banco de dados de instalação são tratadas usando as estruturas descritas na seção Installer Structures.