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

Статья
11/20/2024

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

Требования

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

См. также

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

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