Функция MsiOpenPackageA (msi.h)

Статья
11/20/2024

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

Примечание инициализировать COM в том же потоке перед вызов ом функции MsiOpenPackage, MsiOpenPackageExили MsiOpenProduct.

Синтаксис

UINT MsiOpenPackageA(
  [in]  LPCSTR    szPackagePath,
  [out] MSIHANDLE *hProduct
);

Параметры

[in] szPackagePath

Путь к пакету.

[out] hProduct

Указатель на переменную, которая получает дескриптор продукта.

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

Ценность	Значение
ERROR_BAD_CONFIGURATION	Сведения о конфигурации повреждены.
ERROR_INSTALL_FAILURE	Не удалось открыть продукт.
ERROR_INSTALL_REMOTE_PROHIBITED	Установщик Windows не разрешает установку из подключения к удаленному рабочему столу.
ERROR_INVALID_PARAMETER	Недопустимый параметр передается функции.
ERROR_SUCCESS	Функция успешно завершается.

Если эта функция завершается ошибкой, она может вернуть системный код ошибки. Дополнительные сведения см. в системных кодов ошибок.

Замечания

MsiOpenPackage может принять открытый дескриптор базы данных в форме "#nnnn", где nnnn является дескриптором базы данных в строковой форме, т. е. #123 вместо пути к пакету. Это предназначено для задач разработки, таких как выполнение действий проверки или использование с средствами управления базами данных.

Заметка

Заголовок msi.h определяет MsiOpenPackage в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Установщик 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, требуемом версией установщика Windows, см. в разделе "Требования к установщику Windows Run-Time".
целевая платформа	Виндоус
заголовка	msi.h
библиотеки	Msi.lib
DLL	Msi.dll

См. также

функции запросов к продукту

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