Funções do banco de dados
Este material destina-se a desenvolvedores que estão escrevendo seus próprios programas de instalação e desenvolvedores que desejam saber mais sobre as tabelas de banco de dados do instalador. Para obter informações gerais sobre o instalador, consulte Sobre o Windows Installer.
Você pode usar as funções de acesso do instalador para acessar o banco de dados e o processo de instalação. Essas funções só devem ser usadas por ações de instalação personalizadas e ferramentas de criação. Algumas das funções de acesso do instalador exigem cadeias de caracteres de consulta SQL para consultar o banco de dados. As consultas devem aderir ao instalador sintaxe SQL.
Este tópico lista as funções de acesso ao banco de dados do instalador por categoria.
Funções gerais de acesso ao banco de dados
| Função | Descrição |
|---|---|
| MsiDatabaseCommit | Confirma alterações em um banco de dados. |
| MsiDatabaseGetPrimaryKeys | Retorna os nomes de todas as colunas de chave primária. |
| MsiDatabaseIsTablePersistent | Retorna uma enumeração descrevendo o estado de uma tabela. |
| MsiDatabaseOpenView | Prepara uma consulta de banco de dados e cria um objeto de exibição. |
| MsiGetActiveDatabase | Retorna o banco de dados ativo para a instalação. |
| MsiViewGetColumnInfo | Retorna nomes de colunas ou definições. |
| MsiOpenDatabase | Abre um arquivo de banco de dados para acesso a dados. |
| MsiViewClose | Libera o conjunto de resultados para uma exibição executada. |
| MsiViewExecute | Executa a consulta de exibição e fornece os parâmetros necessários. |
| MsiViewFetch | Obtém o próximo registo sequencial a partir da vista. |
| MsiViewGetError | Retorna o erro que ocorreu na funçãoMsiViewModified. |
| MsiViewModify | Atualiza um registro buscado. |
Funções de gerenciamento de banco de dados
Funções de processamento de registros
| Função | Descrição |
|---|---|
| MsiCreateRecord | Cria um novo objeto de registro com o número especificado de campos. |
| MsiFormatRecord | Formata dados e propriedades de campo de registro usando uma cadeia de caracteres de formato. |
| MsiRecordClearData | Define todos os campos de um registro como null. |
| MsiRecordDataSize | Devolve o comprimento de um campo de registo. |
| MsiRecordGetFieldCount | Devolve o número de campos num registo. |
| MsiRecordGetInteger | Retorna o valor inteiro de um campo de registro. |
| MsiRecordGetString | Retorna o valor da cadeia de caracteres de um campo de registro. |
| MsiRecordIsNull | Informa se um campo de registro é nulo. |
| MsiRecordReadStream | Lê bytes de um campo de fluxo de registro em um buffer. |
| MsiRecordSetInteger | Define um campo de registro como um campo inteiro. |
| MsiRecordSetStream | Define um campo de fluxo de registro de um arquivo. |
| MsiRecordSetString | Copia uma cadeia de caracteres para o campo designado. |
Funções de propriedade de informações de resumo
| Função | Descrição |
|---|---|
| MsiGetSummaryInformation | Obtém identificador para fluxo de informações resumidas do banco de dados do instalador. |
| MsiSummaryInfoGetProperty | Obtém uma única propriedade das informações de resumo. |
| MsiSummaryInfoGetPropertyCount | Retorna o número de propriedades no fluxo de informações de resumo. |
| MsiSummaryInfoPersist | Grava informações de resumo alteradas de volta ao fluxo de informações de resumo. |
| MsiSummaryInfoSetProperty | Define uma única propriedade de informações de resumo. |
Funções de acesso ao estado do instalador
| Função | Descrição |
|---|---|
| MsiGetLanguage | Retorna o idioma numérico da instalação atual. |
| MsiGetLastErrorRecord | Retorna o registro de erro retornado pela última vez para o processo de chamada. |
| MsiGetMode | Retorna um dos estados de instalação interna booleana. |
| MsiGetProperty | Obtém o valor de uma propriedade do instalador. |
| MsiSetProperty | Define o valor de uma propriedade de instalação. |
| MsiSetMode | Define um estado booleano interno do mecanismo. |
Funções de ação do instalador
| Função | Descrição |
|---|---|
| MsiDoAction | Executa ação interna, ação personalizada ou ação do assistente de interface do usuário. |
| MsiEvaluateCondition | Avalia uma expressão condicional que contém nomes e valores de propriedade. |
| MsiProcessMessage | Envia um registro de erro para o instalador para processamento. |
| MsiSequence | Executa uma sequência de ações. |
Funções de localização do instalador
Funções de seleção do instalador
| Função | Descrição |
|---|---|
| MsiEnumComponentCosts | Enumera o espaço em disco por unidade necessário para instalar um componente. |
| MsiGetComponentState | Obtém o estado de um componente. |
| MsiGetFeatureCost | Retorna o espaço em disco exigido por um recurso. |
| MsiGetFeatureState | Obtém o estado de um recurso. |
| MsiGetFeatureValidStates | Retorna um estado de instalação válido. |
| MsiSetComponentState | Define um componente para o estado especificado. |
| MsiSetFeatureAttributes | Modifica os atributos padrão de um recurso em tempo de execução. |
| MsiSetFeatureState | Define um recurso para um estado especificado. |
| MsiSetInstallLevel | Define o nível de instalação de uma instalação completa do produto. |
| MsiVerifyDiskSpace | Verifica se há espaço em disco suficiente. |
Funções da interface do usuário
| Função | Descrição |
|---|---|
| MsiEnableUIPreview | Permite o modo de visualização da interface do usuário. |
| MsiPreviewBillboard | Exibe um outdoor com o controle de host na caixa de diálogo exibida. |
| MsiPreviewDialog | Exibe uma caixa de diálogo como sem moderação e inativa. |
Todas as funções suportam chamadas ANSI e Unicode. Para usar essas funções, inclua MsiQuery.h e link com Msi.lib.
Funções de instalação
Além das funções de acesso ao banco de dados listadas acima, você cria um pacote de instalação para um aplicativo usando as funções do instalador listadas na seção Installer Function Reference.