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.