Función MsiDatabaseImportA (msiquery.h)

  • Artículo

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.

Nota

El encabezado msiquery.h define MsiDatabaseImport como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP
Plataforma de destino Windows
Encabezado msiquery.h
Library Msi.lib
Archivo DLL Msi.dll

Consulte también

Funciones de administración de base de datos

Archivos de archivo de texto