Функция MsiOpenPackageA (msi.h)
Функция MsiOpenPackage открывает пакет для использования с функциями, которые обращаются к базе данных продукта. Функция MsiCloseHandle должна вызываться с дескриптором, если дескриптор не требуется.
Синтаксис
UINT MsiOpenPackageA(
[in] LPCSTR szPackagePath,
[out] MSIHANDLE *hProduct
);
Параметры
[in] szPackagePath
Путь к пакету.
[out] hProduct
Указатель на переменную, получающую дескриптор продукта.
Возвращаемое значение
Значение | Значение |
---|---|
|
Сведения о конфигурации повреждены. |
|
Не удалось открыть продукт. |
|
Установщик Windows не разрешает установку из подключения к удаленному рабочему столу. |
|
В функцию передается недопустимый параметр. |
|
Функция успешно завершается. |
Если эта функция завершается сбоем, она может вернуть код системной ошибки. Дополнительные сведения см. в разделе Системные коды ошибок.
Комментарии
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 |