Compartilhar via


Funções de banco de dados

Este material destina-se a desenvolvedores que estão escrevendo seus próprios programas de instalação e a desenvolvedores que querem aprender mais sobre as tabelas do banco de dados do instalador. Para obter informações gerais sobre o instalador, consulte Sobre o Windows Installer.

É possível usar as funções de acesso do instalador para acessar o banco de dados e o processo de instalação. Essas funções devem ser usadas apenas por ações de instalação personalizadas e ferramentas de autoria. Algumas funções de acesso do instalador exigem cadeias de caracteres de consulta SQL para consultar o banco de dados. As consultas devem seguir a sintaxe SQL do instalador.

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 as alterações em um banco de dados.
MsiDatabaseGetPrimaryKeys Retorna os nomes de todas as colunas de chaves primárias.
MsiDatabaseIsTablePersistent Retorna uma enumeração que descreve 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 ou definições de coluna.
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 Busca o próximo registro sequencial da exibição.
MsiViewGetError Retorna o erro ocorrido na função MsiViewModify.
MsiViewModify Atualiza um registro obtido.

 

Funções de gerenciamento de banco de dados

Função Descrição
MsiCreateTransformSummaryInfo Cria informações resumidas para uma transformação existente.
MsiDatabaseApplyTransform Aplica uma transformação a um banco de dados.
MsiDatabaseExport Exporta uma tabela de um banco de dados aberto para um arquivo de texto.
MsiDatabaseGenerateTransform Gera um arquivo de transformação de diferenças entre dois bancos de dados.
MsiDatabaseImport Importa uma tabela de arquivo de texto do instalador para um banco de dados aberto.
MsiDatabaseMerge Mescla dois bancos de dados.
MsiGetDatabaseState Retorna o estado do banco de dados.

 

Funções de processamento de registro

Função Descrição
MsiCreateRecord Cria um novo objeto de registro com o número de campos especificado.
MsiFormatRecord Formata propriedades e dados de campo de registro usando uma cadeia de caracteres de formato.
MsiRecordClearData Define todos os campos em um registro como nulo.
MsiRecordDataSize Retorna o tamanho de um campo de registro.
MsiRecordGetFieldCount Retorna o número de campos em um registro.
MsiRecordGetInteger Retorna o valor inteiro de um campo de registro.
MsiRecordGetString Retorna o valor da cadeia de caracteres de um campo de registro.
MsiRecordIsNull Relata se um campo de registro for 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 o identificador para o fluxo de informações de resumo 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 no 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 último registro de erro retornado do processo de chamada.
MsiGetMode Retorna um dos estados de instalação internos boolianos.
MsiGetProperty Obtém o valor de uma propriedade do instalador.
MsiSetProperty Define o valor de uma propriedade de instalação.
MsiSetMode Define um estado booliano de mecanismo interno.

 

Funções de ação do instalador

Função Descrição
MsiDoAction Executa ação interna, ação personalizada ou ação de assistente de interface do usuário.
MsiEvaluateCondition Avalia uma expressão condicional contendo nomes e valores de propriedade.
MsiProcessMessage Envia um registro de erro ao instalador para processamento.
MsiSequence Executa uma sequência de ações.

 

Funções de localização do instalador

Função Descrição
MsiGetSourcePath Retorna o caminho de origem completo para uma pasta na tabela de Diretórios.
MsiGetTargetPath Retorna o caminho de destino completo para uma pasta na tabela de Diretórios.
MsiSetTargetPath Define o caminho de destino completo para uma pasta na tabela de Diretórios.

 

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 como 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 Habilita o modo de visualização da interface do usuário.
MsiPreviewBillboard Exibe uma mensagem de instalação com o controle de host na caixa de diálogo exibida.
MsiPreviewDialog Exibe uma caixa de diálogo como sem janela restrita e inativa.

 

Todas as funções dão suporte para chamadas ANSI e Unicode. Para usar essas funções, inclua MsiQuery.h e vincule 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 utilizando as funções do instalador listadas na seção Referência de funções do instalador.