Funções de banco de dados

Esse 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 seguir o 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 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 um modo de exibição executado.
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 que ocorreu na função MsiViewModify.
MsiViewModify	Atualiza um registro buscado.

 

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 arquivo de texto.
MsiDatabaseGenerateTransform	Gera um arquivo de transformação de diferenças entre dois bancos de dados.
MsiDatabaseImport	Importa uma tabela de arquivo morto de texto do instalador para um banco de dados aberto.
MsiDatabaseMerge	Mescla dois bancos de dados juntos.
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 especificado de campos.
MsiFormatRecord	Formata dados de campo de registro e propriedades usando uma cadeia de caracteres de formato.
MsiRecordClearData	Define todos os campos em um registro como nulos.
MsiRecordDataSize	Retorna o comprimento 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 é 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 no 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 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 as informações de resumo alteradas novamente no fluxo de informações de resumo.
MsiSummaryInfoSetProperty	Define uma única propriedade de informações de resumo.

 

Funções de acesso de 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 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 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ção	Descrição
MsiGetSourcePath	Retorna o caminho de origem completo para uma pasta na tabela Diretório.
MsiGetTargetPath	Retorna o caminho de destino completo para uma pasta na tabela Diretório.
MsiSetTargetPath	Define o caminho de destino completo para uma pasta na tabela Diretório.

 

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 suficiente em disco.

 

Funções de interface do usuário

Função	Descrição
MsiEnableUIPreview	Habilita 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 modelagem e inativa.

 

Todas as funções dão suporte a 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 referência de função do instalador de.