Função MsiDatabaseImportW (msiquery.h)

A função MsiDatabaseImport importa um arquivo de arquivo de texto do instalador para uma tabela de banco de dados aberta.

Sintaxe

UINT MsiDatabaseImportW(
  [in] MSIHANDLE hDatabase,
  [in] LPCWSTR   szFolderPath,
  [in] LPCWSTR   szFileName
);

Parâmetros

[in] hDatabase

Manipule para o banco de dados obtido de MsiOpenDatabase.

[in] szFolderPath

Especifica o caminho para a pasta que contém arquivos de arquivo morto.

[in] szFileName

Especifica o nome do arquivo a ser importado.

Valor retornado

A função MsiDatabaseImport retorna um dos seguintes valores:

Comentários

Quando você usa a função MsiDatabaseImport para importar uma tabela de arquivo morto de texto chamada _SummaryInformation para um banco de dados do instalador, você grava o fluxo "05SummaryInformation". Esse fluxo contém propriedades padrão que podem ser exibidas usando o Windows Explorer e são definidas pelo COM. As linhas da tabela são gravadas no fluxo de propriedades como pares de números de ID de propriedade e valores de dados correspondentes. Consulte Resumo Informações Conjunto de Propriedades do Fluxo. A data e a hora em _SummaryInformation estão no formato:YYYY/MM/DD hh::mm::ss. Por exemplo, 1999/03/22 15:25:45. Se a tabela contiver fluxos binários, o nome do fluxo estará no campo de dados e o fluxo real será recuperado de um arquivo desse nome em uma subpasta com o mesmo nome da tabela.

Os arquivos de arquivo de texto exportados de um banco de dados por MsiDatabaseExport destinam-se ao uso com sistemas de controle de versão e não devem ser usados como um meio de editar dados. Use as funções e as ferramentas da API de banco de dados projetadas para essa finalidade. Observe que os caracteres de controle em arquivos de arquivo de texto são convertidos para evitar conflitos com delimitadores de arquivo. Se um arquivo de arquivo de texto contiver dados não ASCII, ele será carimbado com a página de código dos dados e só poderá ser importado para um banco de dados dessa página de código exato ou para um banco de dados neutro. Os bancos de dados neutros são definidos como a página de código do arquivo importado. Um banco de dados pode ser definido incondicionalmente como uma página de código específica importando uma pseudo tabela chamada: _ForceCodepage. O formato desse arquivo é: duas linhas em branco, seguidas por uma linha que contém a página de código numérico, um delimitador de guia e a cadeia de caracteres exata: _ForceCodepage

Essa função não pode ser chamada de ações personalizadas. Uma chamada para essa função de uma ação personalizada faz com que a função falhe.

Se a função falhar, você poderá obter informações de erro estendidas usando MsiGetLastErrorRecord.

Requisitos

Confira também

Funções de gerenciamento de banco de dados

Arquivos de Arquivo de Texto