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 tal como se describe en Obtener 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.

Observaciones

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 llamando a MsiCloseHandle. Para obtener más información, vea la sección Usar PMSIHANDLE en lugar de HANDLE en la 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	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
de la plataforma de destino de	Windows
encabezado de	msiquery.h
biblioteca de	Msi.lib
DLL de	Msi.dll

Consulte también

funciones generales de acceso a bases de datos