Función MsiDatabaseApplyTransformA (msiquery.h)
La función MsiDatabaseApplyTransform aplica una transformación a una base de datos.
Sintaxis
UINT MsiDatabaseApplyTransformA(
[in] MSIHANDLE hDatabase,
[in] LPCSTR szTransformFile,
[in] int iErrorConditions
);
Parámetros
[in] hDatabase
Identificador de la base de datos obtenida de MsiOpenDatabase a la transformación.
[in] szTransformFile
Especifica el nombre del archivo de transformación que se va a aplicar.
[in] iErrorConditions
Condiciones de error que se deben suprimir. Este parámetro es un campo de bits que puede contener los siguientes bits.
| Condición de error | Significado |
|---|---|
|
Se agrega una fila que ya existe. |
|
Se elimina una fila que no existe. |
|
Se agrega una tabla que ya existe. |
|
Se elimina una tabla que no existe. |
|
Se actualiza una fila que no existe. |
|
Las páginas de códigos de la base de datos y de transformación no coinciden y ninguna tiene una página de códigos neutral. |
|
Cree la tabla de _TransformView temporal. |
Valor devuelto
La función MsiDatabaseApplyTransform devuelve uno de los siguientes valores:
Comentarios
La función MsiDatabaseApplyTransform retrasa la transformación de tablas hasta que sea necesario. Las tablas que se van a agregar o quitar se procesan inmediatamente. Sin embargo, los cambios en la tabla existente se retrasan hasta que se carga la tabla o se confirma la base de datos.
Se produce un error si se llama a MsiDatabaseApplyTransform cuando ya se han cargado y guardado tablas en el almacenamiento.
Dado que el delimitador de lista para transformaciones, orígenes y revisiones es un punto y coma, este carácter no debe usarse para nombres de archivo o rutas de acceso.
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 MsiDatabaseApplyTransform 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| 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 |