Referência de função do instalador
Para habilitar o Windows Installer no 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 log
| Nome | Descrição |
|---|---|
| MsiSetInternalUI | Habilita a interface do usuário interna do instalador. |
| MsiSetExternalUI | Habilita um manipulador de interface do usuário externo que recebe mensagens em um formato de cadeia de caracteres. |
| MsiSetExternalUIRecord | Habilita 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. |
Funções de Gerenciamento de Identificadores
| Nome | Descrição |
|---|---|
| MsiCloseHandle | Fecha um identificador de instalação aberto. |
| MsiCloseAllHandles | Fecha todos os identificadores de instalação abertos. Não use para limpeza. |
Funções de instalação e configuração
| Nome | 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 arquivos ausentes. |
| 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 origem 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 origem específico para uma instância de produto especificada. |
| MsiSourceListClearAllEx | Remove todas as fontes existentes de um tipo de origem 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 é registrado como a propriedade "LastUsedSource". Essa função não afeta a lista de fontes registrada. |
| MsiSourceListForceResolutionEx | Remove o registro da fonte atual do produto ou patch, que é registrado como a propriedade "LastUsedSource". Essa função não afeta a lista de fontes registrada. Disponível no Windows Installer 3.0. |
| MsiSourceListGetInfo | Recupera informações sobre a lista de origem de um produto ou patch em um contexto específico. |
| MsiSourceListSetInfo | Define a origem 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 para 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 na fonte de mídia para um produto ou patch em um contexto específico. Disponível no Windows Installer 3.0. |
| MsiSourceListEnumSources | Enumera as fontes na lista de origem de um patch ou produto especificado. Disponível no Windows Installer 3.0. |
Funções específicas do componente
| Nome | Descrição |
|---|---|
| MsiProvideAssembly | Instala e retorna o caminho completo do componente de 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 de um componente qualificado 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 entre contas de usuário e o contexto de instalação.
Windows Installer 4.5 e versões anteriores: sem suporte. |
| 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. |
Funções somente do aplicativo
| Nome | 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 de instalação. |
| MsiUseFeatureEx | Incrementa a contagem de uso de um recurso e indica o estado de instalação. |
| MsiGetProductCode | Retorna o código do produto usando o código do componente. |
Funções de status do sistema
| Nome | Descrição |
|---|---|
| MsiEnumProducts | 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. |
| MsiEnumRelatedProducts | Enumera os produtos instalados no momento com um código de atualização especificado. |
| MsiEnumFeatures | Enumera os recursos publicados. |
| MsiEnumComponents | Enumera os componentes instalados. |
| MsiEnumComponentsEx | Enumera os componentes instalados entre contas de usuário e o contexto de instalação.
Windows Installer 4.5 e versões anteriores: sem suporte. |
| MsiEnumClients | Enumera os clientes de um componente instalado. |
| MsiEnumClientsEx | Enumera os clientes de um componente instalado entre contas de usuário e o contexto de instalação.
Windows Installer 4.5 e versões anteriores: sem suporte. |
| MsiEnumComponentQualifiers | Enumera os qualificadores anunciados de um componente. |
| MsiQueryFeatureState | Retorna o estado instalado de um recurso. |
| MsiQueryFeatureStateEx | Retorna o estado instalado de um recurso de 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 as métricas de uso de um recurso. |
| MsiGetProductInfo | Retorna as informações do produto de produtos publicados e instalados. |
| MsiGetProductInfoEx | Retorna as informações do produto de 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 as informações de usuário registradas para um produto instalado. |
Funções de consulta de produto
| Nome | Descrição |
|---|---|
| MsiOpenProduct | Abre um produto para usar com as funções que acessam o banco de dados. |
| MsiOpenPackage | Abre um pacote a ser usado com as funções que acessam o banco de dados. |
| MsiOpenPackageEx | Abre um pacote a ser usado com as funções que acessam o banco de dados. |
| MsiIsProductElevated | Verifica se o produto foi instalado com privilégios elevados. |
| MsiGetProductInfoFromScript | Retorna as informações do produto de um arquivo de script do instalador. |
| MsiGetProductProperty | Recupera as propriedades no banco de dados do produto. |
| MsiGetShortcutTarget | Examina um atalho e retorna o produto, o nome do recurso e o componente, se disponível. |
| MsiGetFeatureInfo | Retorna as informações descritivas de um recurso. |
| MsiVerifyPackage | Verifica se um arquivo especificado é um pacote de instalação. |
Funções de aplicação de patch
| Nome | 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 aplicativos para um conjunto de patches e produto. Disponível no Windows Installer 3.0. |
| MsiApplyMultiplePatches | Aplica um ou mais patches a 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, essa função recupera a lista de arquivos que podem ser atualizados pelos patches para o destino. Disponível no Windows Installer 4.0. |
| MsiGetPatchInfoEx | Consulta as informações sobre a aplicação de um patch especificado para um produto especificado. Disponível no Windows Installer 3.0. |
| MsiExtractPatchXMLData | Extrai as 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
| Nome | Descrição |
|---|---|
| MsiGetFileHash | Usa 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 de signatário e o hash 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
| Nome | 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. Essa 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, fazendo uma instalação de vários pacotes. Essa função está disponível a partir do Windows Installer 4.5. |
| MsiEndTransaction | Confirma ou reverte todas as instalações pertencentes à transação. Essa função está disponível a partir do Windows Installer 4.5. |
Funções de 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 do banco de dados descritas na seção Funções de Banco de Dados.
Estruturas do Installer
Além disso, algumas informações no banco de dados de instalação são tratadas usando as estruturas descritas na seção Estruturas do Instalador.