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.