Função MsiDatabaseExportA (msiquery.h)

  • Artigo

A função MsiDatabaseExport exporta uma tabela do Microsoft Installer de um banco de dados aberto para um arquivo morto de texto.

Sintaxe

UINT MsiDatabaseExportA(
  [in] MSIHANDLE hDatabase,
  [in] LPCSTR    szTableName,
  [in] LPCSTR    szFolderPath,
  [in] LPCSTR    szFileName
);

Parâmetros

[in] hDatabase

O identificador para um banco de dados do MsiOpenDatabase.

[in] szTableName

O nome da tabela a ser exportada.

[in] szFolderPath

O nome da pasta que contém arquivos mortos.

[in] szFileName

O nome do arquivo morto da tabela exportada.

Retornar valor

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

Código de retorno Descrição
ERROR_BAD_PATHNAME
 Um caminho inválido é passado para a função .
ERROR_FUNCTION_FAILED
 A função falha.
ERROR_INVALID_HANDLE
 Um identificador inválido ou inativo é fornecido.
ERROR_INVALID_PARAMETER
 Um parâmetro inválido é passado para a função .
ERROR_SUCCESS
 A função é bem-sucedida.

Comentários

Se uma tabela contiver fluxos, MsiDatabaseExport exportará cada fluxo para um arquivo separado.

Para obter mais informações, consulte MsiDatabaseImport.

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.

Observação

O cabeçalho msiquery.h define MsiDatabaseExport como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
Plataforma de Destino Windows
Cabeçalho msiquery.h
Biblioteca Msi.lib
DLL Msi.dll

Confira também

Funções de gerenciamento de banco de dados

Arquivos mortos de texto