Compartir a través de

Funciones de base de datos

Este material está destinado a desarrolladores que están escribiendo sus propios programas de instalación y desarrolladores que desean obtener más información sobre las tablas de base de datos del instalador. Para obtener información general sobre el instalador, vea Acerca de Windows Installer.

Puede usar las funciones de acceso del instalador para acceder a la base de datos y al proceso de instalación. Estas funciones solo deben usarse mediante acciones de instalación personalizadas y herramientas de creación. Algunas de las funciones de acceso del instalador requieren cadenas de consulta SQL para consultar la base de datos. Las consultas deben cumplir el instalador sintaxis SQL.

En este tema se enumeran las funciones de acceso a la base de datos del instalador por categoría.

Funciones generales de acceso a bases de datos

Función Descripción
MsiDatabaseCommit Confirma los cambios en una base de datos.
MsiDatabaseGetPrimaryKeys Devuelve los nombres de todas las columnas de clave principal.
MsiDatabaseIsTablePersistent Devuelve una enumeración que describe el estado de una tabla.
MsiDatabaseOpenView Prepara una consulta de base de datos y crea un objeto de vista.
MsiGetActiveDatabase Devuelve la base de datos activa para la instalación.
MsiViewGetColumnInfo Devuelve los nombres de columna o las definiciones.
MsiOpenDatabase Abre un archivo de base de datos para el acceso a datos.
MsiViewClose Libera el conjunto de resultados de una vista ejecutada.
MsiViewExecute Ejecuta la consulta de vista y proporciona los parámetros necesarios.
MsiViewFetch Captura el siguiente registro secuencial de la vista.
MsiViewGetError Devuelve el error que se produjo en la funciónMsiViewModify.
MsiViewModify Actualiza un registro capturado.

 

Funciones de administración de bases de datos

Función Descripción
MsiCreateTransformSummaryInfo Crea información de resumen para una transformación existente.
MsiDatabaseApplyTransform Aplica una transformación a una base de datos.
MsiDatabaseExport Exporta una tabla de una base de datos abierta a un archivo de archivo de texto.
MsiDatabaseGenerateTransform Genera un archivo de transformación de diferencias entre dos bases de datos.
msiDatabaseImport Importa una tabla de archivo de texto del instalador en una base de datos abierta.
MsiDatabaseMerge Combina dos bases de datos juntas.
MsiGetDatabaseState Devuelve el estado de la base de datos.

 

Funciones de procesamiento de registros

Función Descripción
MsiCreateRecord Crea un nuevo objeto de registro con el número especificado de campos.
MsiFormatRecord Da formato a las propiedades y los datos de campo de registro mediante una cadena de formato.
MsiRecordClearData Establece todos los campos de un registro en NULL.
MsiRecordDataSize Devuelve la longitud de un campo de registro.
MsiRecordGetFieldCount Devuelve el número de campos de un registro.
MsiRecordGetInteger Devuelve el valor entero de un campo de registro.
MsiRecordGetString Devuelve el valor de cadena de un campo de registro.
MsiRecordIsNull Informa de si un campo de registro es NULL.
MsiRecordReadStream Lee bytes de un campo de flujo de registro en un búfer.
MsiRecordSetInteger Establece un campo de registro en un campo entero.
MsiRecordSetStream Establece un campo de secuencia de registros de un archivo.
MsiRecordSetString Copia una cadena en el campo designado.

 

Funciones de propiedad Información de resumen

Función Descripción
msiGetSummaryInformation Obtiene el identificador del flujo de información de resumen de la base de datos del instalador.
MsiSummaryInfoGetProperty Obtiene una sola propiedad de la información de resumen.
MsiSummaryInfoGetPropertyCount Devuelve el número de propiedades del flujo de información de resumen.
MsiSummaryInfoPersist Vuelve a escribir información de resumen modificada en el flujo de información de resumen.
MsiSummaryInfoSetProperty Establece una única propiedad de información de resumen.

 

Funciones de acceso de estado del instalador

Función Descripción
MsiGetLanguage Devuelve el idioma numérico de la instalación actual.
MsiGetLastErrorRecord Devuelve el último registro de error devuelto para el proceso de llamada.
MsiGetMode Devuelve uno de los estados de instalación interna booleano.
MsiGetProperty Obtiene el valor de una propiedad del instalador.
MsiSetProperty Establece el valor de una propiedad de instalación.
MsiSetMode Establece un estado booleano del motor interno.

 

Funciones de acción del instalador

Función Descripción
MsiDoAction Ejecuta una acción integrada, una acción personalizada o una acción del asistente para la interfaz de usuario.
MsiEvaluateCondition Evalúa una expresión condicional que contiene los nombres de propiedad y los valores.
MsiProcessMessage Envía un registro de error al instalador para su procesamiento.
MsiSequence Ejecuta una secuencia de acciones.

 

Funciones de ubicación del instalador

Función Descripción
MsiGetSourcePath Devuelve la ruta de acceso de origen completa de una carpeta de la tabla Directory.
msiGetTargetPath Devuelve la ruta de acceso de destino completa de una carpeta de la tabla Directory.
msiSetTargetPath Establece la ruta de acceso de destino completa de una carpeta de la tabla Directorio.

 

Funciones de selección del instalador

Función Descripción
MsiEnumComponentCosts Enumera el espacio en disco por unidad necesario para instalar un componente.
MsiGetComponentState Obtiene el estado de un componente.
msiGetFeatureCost Devuelve el espacio en disco requerido por una característica.
MsiGetFeatureState Obtiene el estado de una característica.
MsiGetFeatureValidStates Devuelve un estado de instalación válido.
MsiSetComponentState Establece un componente en el estado especificado.
MsiSetFeatureAttributes Modifica los atributos predeterminados de una característica en tiempo de ejecución.
MsiSetFeatureState Establece una característica en un estado especificado.
msiSetInstallLevel Establece el nivel de instalación de una instalación completa del producto.
MsiVerifyDiskSpace Comprueba si hay suficiente espacio en disco.

 

Funciones de interfaz de usuario

Función Descripción
MsiEnableUIPreview Habilita el modo de vista previa de la interfaz de usuario.
MsiPreviewBillboard Muestra una cartelera con el control host en el cuadro de diálogo mostrado.
MsiPreviewDialog Muestra un cuadro de diálogo como modelos e inactivos.

 

Todas las funciones admiten llamadas ANSI y Unicode. Para usar estas funciones, incluya MsiQuery.h y vincule con Msi.lib.

Funciones de instalación

Además de las funciones de acceso a la base de datos enumeradas anteriormente, se crea un paquete de instalación para una aplicación mediante las funciones del instalador enumeradas en la sección referencia de función del instalador de .

 

 

  • Last updated on