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

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

  • Статья

Функция MsiConfigureFeature настраивает состояние установленного компонента продукта.

Синтаксис

UINT MsiConfigureFeatureW(
  [in] LPCWSTR      szProduct,
  [in] LPCWSTR      szFeature,
  [in] INSTALLSTATE eInstallState
);

Параметры

[in] szProduct

Указывает код продукта для настраиваемого продукта.

[in] szFeature

Указывает идентификатор компонента для настраиваемого компонента.

[in] eInstallState

Указывает состояние установки компонента. Этот параметр должен иметь одно из следующих значений.

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

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

Значение Значение
ERROR_INVALID_PARAMETER
 В функцию передается недопустимый параметр.
ERROR_SUCCESS
 Функция выполнена успешно.
Ошибка, связанная с действием
 Дополнительные сведения см. в разделе Коды ошибок.
Ошибка инициализации
 Произошла ошибка, связанная с инициализацией.

Комментарии

Примечание

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

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

Отображаемые сообщения об ошибках

Код ошибки

Ошибка инициализации

Функции установки и конфигурации

Установка с несколькими пакетами