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

  • Статья

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

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

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