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 |