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

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

  • Статья

Функция 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 или Юникод этой функции на основе определения константы препроцессора 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

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

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