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

  • Статья

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

Синтаксис

UINT MsiConfigureProductA(
  [in] LPCSTR       szProduct,
  [in] int          iInstallLevel,
  [in] INSTALLSTATE eInstallState
);

Параметры

[in] szProduct

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

[in] iInstallLevel

Указывает, какая часть продукта должна быть установлена при установке продукта в состоянии по умолчанию. Параметр iInstallLevel игнорируется, и устанавливаются все компоненты, если для параметра eInstallState задано любое другое значение, кроме INSTALLSTATE_DEFAULT.

Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
INSTALLLEVEL_DEFAULT
 Устанавливаются созданные по умолчанию компоненты.
INSTALLLEVEL_MINIMUM
 Устанавливаются только необходимые компоненты. Вы можете указать значение между INSTALLLEVEL_MINIMUM и INSTALLLEVEL_MAXIMUM, чтобы установить подмножество доступных функций.
INSTALLLEVEL_MAXIMUM
 Все компоненты установлены. Вы можете указать значение между INSTALLLEVEL_MINIMUM и INSTALLLEVEL_MAXIMUM, чтобы установить подмножество доступных функций.

[in] eInstallState

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

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

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

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

Комментарии

Функция MsiConfigureProduct отображает пользовательский интерфейс с использованием текущих параметров. Параметры пользовательского интерфейса можно изменить с помощью MsiSetInternalUI, MsiSetExternalUI или MsiSetExternalUIRecord.

Параметр iInstallLevel игнорируется, и устанавливаются все компоненты продукта, если для параметра eInstallState задано любое другое значение, отличное от INSTALLSTATE_DEFAULT. Чтобы управлять установкой отдельных компонентов, если параметру eInstallState не задано значение INSTALLSTATE_DEFAULT, используйте MsiConfigureFeature.

Примечание

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

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

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