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

Статья
11/20/2024

Функция 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Установщик 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

См. также

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

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