Função MsiGetActiveDatabase (msiquery.h)
A função MsiGetActiveDatabase retorna o banco de dados ativo para a instalação. Essa função retorna um identificador somente leitura que deve ser fechado usando MsiCloseHandle.
Sintaxe
MSIHANDLE MsiGetActiveDatabase(
[in] MSIHANDLE hInstall
);
Parâmetros
[in] hInstall
Manipule para a instalação fornecida a uma ação personalizada de DLL ou obtida por meio de MsiOpenPackage, MsiOpenPackageEx ou MsiOpenProduct.
Valor retornado
Se a função for bem-sucedida, ela retornará um identificador somente leitura para o banco de dados atualmente em uso pelo instalador. Se a função falhar, a função retornará zero, 0.
Comentários
A função MsiGetActiveDatabase acessa o banco de dados em uso pela execução da instalação.
Observe que é recomendável usar variáveis do tipo PMSIHANDLE porque o instalador fecha objetos PMSIHANDLE à medida que eles saem do escopo, enquanto você deve fechar objetos MSIHANDLE chamando MsiCloseHandle. Para obter mais informações, confira a seção Use PMSIHANDLE em vez de HANDLE nas Melhores práticas do Windows Installer.
Requisitos
| Cliente mínimo com suporte | Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP |
| Plataforma de Destino | Windows |
| Cabeçalho | msiquery.h |
| Biblioteca | Msi.lib |
| DLL | Msi.dll |