Compartir a través de


Función MsiViewExecute (msiquery.h)

La función MsiViewExecute ejecuta una consulta de vista SQL y proporciona los parámetros necesarios. La consulta usa el token de signo de interrogación para representar parámetros como se describe en Sintaxis SQL. Los valores de estos parámetros se pasan como los campos correspondientes de un registro de parámetro.

Sintaxis

UINT MsiViewExecute(
  [in] MSIHANDLE hView,
  [in] MSIHANDLE hRecord
);

Parámetros

[in] hView

Controle la vista sobre la que se va a ejecutar la consulta.

[in] hRecord

Identificador de un registro que proporciona los parámetros. Este parámetro contiene valores para reemplazar los tokens de parámetro de la consulta SQL. Es opcional, por lo que hRecord puede ser cero. Para obtener una referencia sobre la sintaxis, consulte Sintaxis SQL.

Valor devuelto

Tenga en cuenta que, en situaciones de memoria baja, esta función puede generar una excepción de STATUS_NO_MEMORY.

Comentarios

Se debe llamar a la función MsiViewExecute antes de cualquier llamada a MsiViewFetch.

Si la consulta SQL especifica valores con marcadores de parámetros (?), se debe proporcionar un registro que contenga todos los valores de reemplazo en el orden exacto y de los tipos de datos compatibles. Cuando se usa con las consultas INSERT y UPDATE, todos los valores con parámetros deben preceder a todos los valores no parametrizados.

Por ejemplo, estas consultas son válidas.

UPDATE {table-list} SET {column}= ? , {column}= {constant}

INSERT INTO {table} ({column-list}) VALUES (?, {constant-list})

Sin embargo, estas consultas no son válidas.

UPDATE {table-list} SET {column}= {constant}, {column}=?

INSERT INTO {table} ({column-list}) VALUES ({constant-list}, ? )

Si se produce un error en la función, puede obtener información de error extendida mediante MsiGetLastErrorRecord.

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