Compartir a través de


Funciones de base de datos

Este material está destinado a desarrolladores que escriben sus propios programas de instalación y a desarrolladores que quieren más información sobre las tablas de base de datos de instalador. Para información general sobre el instalador, consulte 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 herramientas de creación y acciones de instalación personalizadas. Algunas de las funciones de acceso del instalador requieren cadenas de consulta SQL para consultar la base de datos. Las consultas deben cumplir la sintaxis SQL del instalador.

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

Funciones generales de acceso a base 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 definiciones o nombres de columna.
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 suministra los parámetros necesarios.
MsiViewFetch Captura el registro secuencial siguiente de la vista.
MsiViewGetError Devuelve el error que se produjo en la función MsiViewModify.
MsiViewModify Actualiza un registro capturado.

 

Funciones de administración de base 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 almacenamiento 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 a 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 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 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 flujo de registro de un archivo.
MsiRecordSetString Copia una cadena en el campo designado.

 

Funciones de propiedad de información de resumen

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

 

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 booleanos de instalación internos.
MsiGetProperty Obtiene el valor de una propiedad del instalador.
MsiSetProperty Establece el valor de una propiedad de instalación.
MsiSetMode Establece un estado booleano de motor interno.

 

Funciones de acción del instalador

Función Descripción
MsiDoAction Ejecuta la acción integrada, la acción personalizada o la acción del asistente para la interfaz de usuario.
MsiEvaluateCondition Evalúa una expresión condicional que contiene valores y nombres de propiedad.
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 Directory.

 

Funciones de selección del instalador

Función Descripción
MsiEnumComponentCosts Enumera el espacio en disco por unidad que se requiere para instalar un componente.
MsiGetComponentState Obtiene el estado de un componente.
MsiGetFeatureCost Devuelve el espacio en disco que una característica requiere.
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 de un producto.
MsiVerifyDiskSpace Comprueba si hay espacio en disco suficiente.

 

Funciones de la 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 inactivo y sin modelo.

 

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 que se enumeraron anteriormente, puede crear un paquete de instalación para una aplicación mediante las funciones del instalador que se indican en la sección Referencia de funciones del instalador.