Función MsiDatabaseOpenViewA (msiquery.h)

  • Artículo

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

Consulte también

Funciones generales de acceso a base de datos