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

  • Статья

Функция MsiConfigureProductEx устанавливает или удаляет продукт. Можно также указать командную строку продукта.

Синтаксис

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

Параметры

[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
 Продукт объявляется.

[in] szCommandLine

Задает параметры свойства командной строки. Это должен быть список формата Property=Setting Property=Setting. Дополнительные сведения см. в разделе Сведения о свойствах.

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

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

Комментарии

Командная строка, передаваемая как szCommandLine , может содержать любые свойства параметров установки компонентов. В этом случае передаваемый параметр eInstallState должен быть INSTALLSTATE_DEFAULT.

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

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

Примечание

Заголовок msi.h определяет MsiConfigureProductEx как псевдоним, который автоматически выбирает версию 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, см. в статье Требования к установщику Windows Run-Time.
Целевая платформа Windows
Header msi.h
Библиотека Msi.lib
DLL Msi.dll

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

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

Код ошибки

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

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

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