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

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

  • Статья

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

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

Синтаксис

UINT MsiOpenProductW(
  [in]  LPCWSTR   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

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

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