Функция MsiSetInstallLevel (msiquery.h)

Статья
08/25/2023

Функция MsiSetInstallLevel задает уровень установки для полной установки продукта.

Синтаксис

UINT MsiSetInstallLevel(
  [in] MSIHANDLE hInstall,
  [in] int       iInstallLevel
);

Параметры

[in] hInstall

Дескриптор установки, предоставленной для настраиваемого действия DLL или полученной с помощью MsiOpenPackage, MsiOpenPackageEx или MsiOpenProduct.

[in] iInstallLevel

Уровень установки.

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

Функция MsiSetInstallLevel возвращает одно из следующих значений:

Уровень установки для текущей установки с указанным значением.
Состояния Select и Installed (Выбор) и Installed (Установленные) для всех компонентов в таблице Компонентов.
Состояние действия каждого компонента в таблице Компонент на основе нового уровня.

Для любой установки существует определенный уровень установки, который является целочисленным значением от 1 до 32 767. Начальное значение определяется свойством INSTALLLEVEL , которое задается в таблице свойств.

Если в параметре iInstallLevel передается 0 (ноль) или отрицательное число, текущий уровень установки не изменяется, но все компоненты по-прежнему обновляются в зависимости от текущего уровня установки. Дополнительные сведения см. в разделе Вызов функций базы данных из программ.

В случае сбоя функции можно получить расширенные сведения об ошибке с помощью MsiGetLastErrorRecord.

Требования

Требование	Значение
Минимальная версия клиента	Установщик 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
Header	msiquery.h
Библиотека	Msi.lib
DLL	Msi.dll

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

Функции выбора установщика