Compartilhar via

Função MsiGetActiveDatabase (msiquery.h)

  • Artigo

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

Confira também

Funções gerais de acesso ao banco de dados