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

Статья
11/20/2024

Функция 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 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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Установщик 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".
целевая платформа	Виндоус
заголовка	msi.h
библиотеки	Msi.lib
DLL	Msi.dll

См. также

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

коды ошибок

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

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

Multiple-Package установки

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