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


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

Функция 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

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

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