Функция MsiConfigureProductA (msi.h)
Функция MsiConfigureProduct устанавливает или удаляет продукт.
Синтаксис
UINT MsiConfigureProductA(
[in] LPCSTR szProduct,
[in] int iInstallLevel,
[in] INSTALLSTATE eInstallState
);
Параметры
[in] szProduct
Указывает код продукта для настраиваемого продукта.
[in] iInstallLevel
Указывает, какая часть продукта должна быть установлена при установке продукта в состоянии по умолчанию. Параметр iInstallLevel игнорируется, и устанавливаются все компоненты, если для параметра eInstallState задано любое другое значение, кроме INSTALLSTATE_DEFAULT.
Этот параметр может принимать одно из указанных ниже значений.
[in] eInstallState
Указывает состояние установки продукта. Этот параметр может принимать одно из указанных ниже значений.
Значение | Значение |
---|---|
|
Продукт должен быть установлен со всеми компонентами, установленными локально. |
|
Продукт удаляется. |
|
Продукт должен быть установлен со всеми компонентами, установленными для запуска из источника. |
|
Продукт устанавливается со всеми компонентами, установленными в состояниях по умолчанию, указанных в таблице компонентов. |
|
Продукт объявляется. |
Возвращаемое значение
Значение | Значение |
---|---|
|
В функцию передается недопустимый параметр. |
|
Функция выполнена успешно. |
|
Дополнительные сведения см. в разделе Коды ошибок. |
Ошибка, связанная с инициализацией. |
Комментарии
Функция 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 |