Funzione MsiViewFetch (msiquery.h)

La funzione MsiViewFetch recupera il record sequenziale successivo dalla visualizzazione. Questa funzione restituisce un handle che deve essere chiuso usando MsiCloseHandle.

Sintassi

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

Parametri

[in] hView

Handle per la visualizzazione da cui recuperare.

[out] phRecord

Puntatore all'handle per il record recuperato.

Valore restituito

Si noti che in situazioni di memoria insufficiente questa funzione può generare un'eccezione STATUS_NO_MEMORY.

Commenti

Se la funzione MsiViewFetch restituisce ERROR_FUNCTION_FAILED, è possibile che la funzione MsiViewExecute non sia stata chiamata per prima. Se nel set di risultati sono disponibili più righe, MsiViewFetch restituisce phRecord come handle a un record contenente i dati delle colonne richieste oppure phRecord è 0. Per ottenere prestazioni massime, è consigliabile usare lo stesso record per tutti i recupero oppure il record deve essere rilasciato eliminando l'ambito.

Si noti che è consigliabile usare variabili di tipo PMSIHANDLE perché il programma di installazione chiude gli oggetti PMSIHANDLE quando escono dall'ambito, mentre è necessario chiudere gli oggetti MSIHANDLE chiamando MsiCloseHandle. Per altre informazioni, vedere Usare PMSIHANDLE anziché la sezione HANDLE in Procedure consigliate per Windows Installer.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Installer 5.0 in Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 in Windows Server 2008 o Windows Vista. Windows Installer in Windows Server 2003 o Windows XP
Piattaforma di destinazione	Windows
Intestazione	msiquery.h
Libreria	Msi.lib
DLL	Msi.dll

Vedi anche

Funzioni generali di accesso al database

Uso delle query