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 |