Función MsiDatabaseOpenViewA (msiquery.h)
La función MsiDatabaseOpenView prepara una consulta de base de datos y crea un objeto de vista. Esta función devuelve un identificador que se debe cerrar mediante MsiCloseHandle.
Sintaxis
UINT MsiDatabaseOpenViewA(
[in] MSIHANDLE hDatabase,
[in] LPCSTR szQuery,
[out] MSIHANDLE *phView
);
Parámetros
[in] hDatabase
Identificador de la base de datos a la que desea abrir un objeto de vista. Puede obtener el identificador como se describe en Obtención de un identificador de base de datos.
[in] szQuery
Especifica una cadena de consulta SQL para consultar la base de datos. Para obtener una sintaxis correcta, consulte Sintaxis sql.
[out] phView
Puntero a un identificador de la vista devuelta.
Valor devuelto
La función MsiDatabaseOpenView devuelve uno de los siguientes valores:
ERROR_SUCCESS si se ejecuta correctamente y el identificador de vista al que apunta el parámetro phView [out] está establecido.
ERROR_INVALID_HANDLE, ERROR_INVALID_HANDLE_STATE, ERROR_BAD_QUERY_SYNTAX o ERROR_GEN_FAILURE si se produce un error y establece el registro de error, accesible a través de MsiGetLastErrorRecord.
Comentarios
La función MsiDatabaseOpenView abre un objeto de vista para una base de datos. Debe abrir un objeto de vista para una base de datos antes de realizar cualquier ejecución o captura.
Si se produce un error, puede llamar a MsiGetLastErrorRecord para obtener más información.
Tenga en cuenta que se recomienda usar variables de tipo PMSIHANDLE porque el instalador cierra los objetos PMSIHANDLE a medida que salen del ámbito, mientras que debe cerrar objetos MSIHANDLE mediante una llamada a MsiCloseHandle. Para más información, consulte la sección Uso de PMSIHANDLE, en lugar de HANDLE en los procedimientos recomendados de Windows Installer.
Si se produce un error en la función, puede obtener información de error extendida mediante MsiGetLastErrorRecord.
Nota
El encabezado msiquery.h define MsiDatabaseOpenView 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o 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 |