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


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

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

Синтаксис

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

Параметры

[in] hInstall

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

[in] iInstallLevel

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

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

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

Комментарии

Функция 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

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

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