Función MsiGetActiveDatabase (msiquery.h)

  • Artículo

La función MsiGetActiveDatabase devuelve la base de datos activa para la instalación. Esta función devuelve un identificador de solo lectura que se debe cerrar mediante MsiCloseHandle.

Sintaxis

MSIHANDLE MsiGetActiveDatabase(
  [in] MSIHANDLE hInstall
);

Parámetros

[in] hInstall

Identificador de la instalación proporcionada a una acción personalizada de DLL o obtenida a través de MsiOpenPackage, MsiOpenPackageEx o MsiOpenProduct.

Valor devuelto

Si la función se realiza correctamente, devuelve un identificador de solo lectura a la base de datos actualmente en uso por el instalador. Si se produce un error en la función, la función devuelve cero, 0.

Comentarios

La función MsiGetActiveDatabase tiene acceso a la base de datos en uso mediante la ejecución de la instalación.

Tenga en cuenta que se recomienda usar variables de tipo PMSIHANDLE porque el instalador cierra los objetos PMSIHANDLE a medida que salen del ámbito, mientras que debe cerrar objetos MSIHANDLE mediante una llamada a MsiCloseHandle. Para más información, consulte la sección Uso de PMSIHANDLE, en lugar de HANDLE en los procedimientos recomendados de Windows Installer.

Requisitos

   
Cliente mínimo compatible Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP
Plataforma de destino Windows
Encabezado msiquery.h
Library Msi.lib
Archivo DLL Msi.dll

Consulte también

Funciones generales de acceso a base de datos