Funzione MsiGetActiveDatabase (msiquery.h)
La funzione MsiGetActiveDatabase restituisce il database attivo per l'installazione. Questa funzione restituisce un handle di sola lettura che deve essere chiuso usando MsiCloseHandle.
Sintassi
MSIHANDLE MsiGetActiveDatabase(
[in] MSIHANDLE hInstall
);
Parametri
[in] hInstall
Gestire l'installazione fornita a un'azione personalizzata DLL o ottenuta tramite MsiOpenPackage, MsiOpenPackageEx o MsiOpenProduct.
Valore restituito
Se la funzione ha esito positivo, restituisce un handle di sola lettura al database attualmente in uso dal programma di installazione. Se la funzione ha esito negativo, la funzione restituisce zero, 0.
Commenti
La funzione MsiGetActiveDatabase accede al database in uso eseguendo l'installazione.
Si noti che è consigliabile usare variabili di tipo PMSIHANDLE perché il programma di installazione chiude gli oggetti PMSIHANDLE mentre escono dall'ambito, mentre è necessario chiudere gli oggetti MSIHANDLE chiamando MsiCloseHandle. Per altre informazioni, vedere Usare PMSIHANDLE anziché la sezione HANDLE nelle procedure consigliate di Windows Installer.
Requisiti
| 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 |