Поделиться через


Функция MsiGetActiveDatabase (msiquery.h)

Функция MsiGetActiveDatabase возвращает активную базу данных для установки. Эта функция возвращает дескриптор только для чтения, который должен быть закрыт с помощью MsiCloseHandle.

Синтаксис

MSIHANDLE MsiGetActiveDatabase(
  [in] MSIHANDLE hInstall
);

Параметры

[in] hInstall

Обработка установки, предоставленной пользовательскому действию DLL или полученная с помощью MsiOpenPackage, MsiOpenPackageEx или MsiOpenProduct.

Возвращаемое значение

Если функция выполняется успешно, она возвращает дескриптор только для чтения в базу данных, используемую установщиком. Если функция завершается сбоем, функция возвращает ноль, 0.

Комментарии

Функция MsiGetActiveDatabase обращается к базе данных, используемой запущенной установкой.

Обратите внимание, что рекомендуется использовать переменные типа PMSIHANDLE, так как установщик закрывает объекты PMSIHANDLE по мере их выхода из область, тогда как необходимо закрывать объекты MSIHANDLE путем вызова MsiCloseHandle. Дополнительные сведения см. в разделе Использование PMSIHANDLE вместо HANDLE статьи Рекомендации по установщику Windows.

Требования

   
Минимальная версия клиента Установщик Windows 5.0 в Windows Server 2012, Windows 8, Windows Server 2008 R2 или Windows 7. Установщик Windows 4.0 или Установщик Windows 4.5 в Windows Server 2008 или Windows Vista. Установщик Windows в Windows Server 2003 или Windows XP
Целевая платформа Windows
Header msiquery.h
Библиотека Msi.lib
DLL Msi.dll

См. также раздел

Общие функции доступа к базе данных