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

  • Статья

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

Синтаксис

INSTALLSTATE MsiUseFeatureExA(
  [in] LPCSTR szProduct,
  [in] LPCSTR szFeature,
  [in] DWORD  dwInstallMode,
  [in] DWORD  dwReserved
);

Параметры

[in] szProduct

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

[in] szFeature

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

[in] dwInstallMode

Этот параметр может иметь следующее значение.

Значение Значение
INSTALLMODE_NODETECTION
 Возвращаемое значение указывает состояние установки.

[in] dwReserved

Зарезервировано для последующего использования. Это значение должно быть равно 0.

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

Значение Значение
INSTALLSTATE_ABSENT
 Компонент не установлен.
INSTALLSTATE_ADVERTISED
 Функция объявлена
INSTALLSTATE_LOCAL
 Компонент установлен локально и доступен для использования.
INSTALLSTATE_SOURCE
 Компонент устанавливается из источника и доступен для использования.
INSTALLSTATE_UNKNOWN
 Функция не опубликована.

Комментарии

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

Примечание

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

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

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