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

Статья
11/20/2024

Функция MsiUseFeature увеличивает количество использования для определенной функции и указывает состояние установки для этой функции. Эта функция должна использоваться для указания намерения приложения использовать функцию.

Синтаксис

INSTALLSTATE MsiUseFeatureA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature
);

Параметры

[in] szProduct

Указывает код продукта для продукта, которому принадлежит используемая функция.

[in] szFeature

Определяет используемую функцию.

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

Ценность	Значение
INSTALLSTATE_ABSENT	Компонент не установлен.
INSTALLSTATE_ADVERTISED	Функция объявлена
INSTALLSTATE_BADCONFIG	Данные конфигурации повреждены.
INSTALLSTATE_INVALIDARG	Недопустимый аргумент функции.
INSTALLSTATE_LOCAL	Эта функция устанавливается локально и доступна для использования.
INSTALLSTATE_SOURCE	Эта функция устанавливается из источника и доступна для использования.
INSTALLSTATE_UNKNOWN	Функция не опубликована.

Замечания

Функцию MsiUseFeature следует использовать только для опубликованных функций. INSTALLSTATE_UNKNOWN указывает, что программа пытается использовать функцию, которая не опубликована. Приложение должно определить, публикуется ли функция перед вызовом MsiUseFeature путем вызова MsiQueryFeatureState или MsiEnumFeatures. Приложение должно выполнять эти вызовы во время инициализации. Приложение должно использовать только функции, известные как опубликованные.

Заметка

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

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