Función MsiViewFetch (msiquery.h)

La función MsiViewFetch captura el siguiente registro secuencial de la vista. Esta función devuelve un identificador que se debe cerrar mediante MsiCloseHandle.

Sintaxis

UINT MsiViewFetch(
  [in]  MSIHANDLE hView,
  [out] MSIHANDLE *phRecord
);

Parámetros

[in] hView

Identificador de la vista desde la que se va a capturar.

[out] phRecord

Puntero al identificador del registro capturado.

Valor devuelto

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

Comentarios

Si la función MsiViewFetch devuelve ERROR_FUNCTION_FAILED, es posible que la función MsiViewExecute no se haya llamado primero. Si hay más filas disponibles en el conjunto de resultados, MsiViewFetch devuelve phRecord como identificador de un registro que contiene los datos de columna solicitados o phRecord es 0. Para obtener el máximo rendimiento, se debe usar el mismo registro para todas las recuperaciones o el registro debe liberarse al salir del ámbito.

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 más información, consulte la sección Uso de PMSIHANDLE, en lugar de HANDLE en los procedimientos recomendados de Windows Installer.

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

Trabajar con consultas