Función MsiDatabaseImportA (msiquery.h)

La función MsiDatabaseImport importa un archivo de archivo de texto del instalador en una tabla de base de datos abierta.

Sintaxis

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

Parámetros

[in] hDatabase

Identificador de la base de datos obtenida de MsiOpenDatabase.

[in] szFolderPath

Especifica la ruta de acceso a la carpeta que contiene archivos de archivo.

[in] szFileName

Especifica el nombre del archivo que se va a importar.

Valor devuelto

La función MsiDatabaseImport devuelve uno de los siguientes valores:

Comentarios

Cuando se usa la función MsiDatabaseImport para importar una tabla de archivo de texto denominada _SummaryInformation en una base de datos del instalador, se escribe la secuencia "05SummaryInformation". Esta secuencia contiene propiedades estándar que se pueden ver mediante el Explorador de Windows y que se definen mediante COM. Las filas de la tabla se escriben en el flujo de propiedades como pares de números de identificador de propiedad y los valores de datos correspondientes. Vea Conjunto de propiedades De flujo de información de resumen. La fecha y la hora en _SummaryInformation tienen el formato: AAAA/MM/DD hh::mm::ss. Por ejemplo, 1999/03/22 15:25:45. Si la tabla contiene secuencias binarias, el nombre de la secuencia se encuentra en el campo de datos y la secuencia real se recupera de un archivo de ese nombre en una subcarpeta con el mismo nombre que la tabla.

Los archivos de archivo de texto exportados desde una base de datos por MsiDatabaseExport están diseñados para su uso con sistemas de control de versiones y no están diseñados para usarse como medio de edición de datos. Use las funciones y herramientas de la API de base de datos diseñadas para ese propósito. Tenga en cuenta que los caracteres de control de los archivos de archivo de texto se traducen para evitar conflictos con delimitadores de archivos. Si un archivo de archivo de texto contiene datos no ASCII, se marca con la página de códigos de los datos y solo se puede importar en una base de datos de esa página de códigos exacta o en una base de datos neutral. Las bases de datos neutras se establecen en la página de códigos del archivo importado. Una base de datos se puede establecer incondicionalmente en una página de códigos determinada importando una pseudo tabla denominada: _ForceCodepage. El formato de este archivo es: dos líneas en blanco, seguidas de una línea que contiene la página de códigos numéricas, un delimitador de tabulación y la cadena exacta: _ForceCodepage

No se puede llamar a esta función desde acciones personalizadas. Una llamada a esta función desde una acción personalizada hace que se produzca un error en la función.

Si se produce un error en la función, puede obtener información de error extendida mediante MsiGetLastErrorRecord.

Requisitos

Consulte también

Funciones de administración de base de datos

Archivos de archivo de texto