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

Статья
03/05/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.
Целевая платформа	Windows
Header	msi.h
Библиотека	Msi.lib
DLL	Msi.dll

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

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

Share via