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.