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

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

  • Статья

Функция MsiGetProductCode возвращает код продукта приложения с помощью кода компонента установленного или объявленного компонента приложения. Во время инициализации приложение должно определить, под каким кодом продукта оно было установлено или объявлено.

Синтаксис

UINT MsiGetProductCodeA(
  [in]  LPCSTR szComponent,
  [out] LPSTR  lpBuf39
);

Параметры

[in] szComponent

Этот параметр задает код компонента, установленного приложением. Обычно это код компонента, содержащего исполняемый файл приложения.

[out] lpBuf39

Указатель на буфер, который получает код продукта. Этот буфер должен содержать 39 символов. Первые 38 символов предназначены для GUID, а последний — для завершающего символа NULL.

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

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

Комментарии

Во время инициализации приложение должно определить код продукта, под которым оно было установлено. Приложение может быть частью различных продуктов в разных установках. Например, приложение может входить в набор приложений или устанавливаться само по себе.

Примечание

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

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

Функции, доступные только для приложений