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

Статья
08/24/2023

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

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

Синтаксис

UINT MsiOpenProductA(
  [in]  LPCSTR    szProduct,
  [out] MSIHANDLE *hProduct
);

Параметры

[in] szProduct

Указывает код открываемого продукта.

[out] hProduct

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

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

Значение	Значение
ERROR_BAD_CONFIGURATION	Сведения о конфигурации повреждены.
ERROR_INSTALL_FAILURE	Не удалось открыть продукт.
ERROR_INSTALL_SOURCE_ABSENT	Источник был недоступен.
ERROR_INVALID_PARAMETER	В функцию передан недопустимый параметр.
ERROR_SUCCESS	Функция успешно завершена.
ERROR_UNKNOWN_PRODUCT	Код продукта не был обнаружен.

Заголовок msi.h определяет MsiOpenProduct как псевдоним, который автоматически выбирает версию 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

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

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