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

Статья
11/20/2024

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

Синтаксис

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

Требования

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

См. также

функций Application-Only

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