MsiSetInstallLevel 函数 (msiquery.h)

MsiSetInstallLevel 函数设置完整产品安装的安装级别。

语法

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

参数

[in] hInstall

提供给 DLL 自定义操作或使用 MsiOpenPackage、MsiOpenPackageExMsiOpenProduct 获取的安装的句柄。

[in] iInstallLevel

安装级别。

返回值

MsiSetInstallLevel 函数返回以下值之一:

注解

MsiSetInstallLevel 函数设置以下内容:

  • 当前安装的安装级别为指定值。
  • 功能 表中所有功能的“选择”和“已安装”状态。
  • 组件 表中每个组件的操作状态(基于新级别)。
对于任何安装,都有一个定义的安装级别,即 1 到 32,767 之间的一个整数值。 初始值由 INSTALLLEVEL 属性确定,该属性在 属性表中设置。

如果 0 (零) 或在 iInstallLevel 参数中传递负数,则当前安装级别不会更改,但仍会根据当前安装级别更新所有功能。 有关详细信息,请参阅 从程序调用数据库函数

如果函数失败,可以使用 MsiGetLastErrorRecord 获取扩展错误信息。

要求

要求
最低受支持的客户端 Windows Server 2012、Windows 8、Windows Server 2008 R2 或 Windows 7 上的 Windows Installer 5.0。 Windows Server 2008 或 Windows Vista 上的 Windows Installer 4.0 或 Windows Installer 4.5。 Windows Server 2003 或 Windows XP 上的 Windows Installer
目标平台 Windows
标头 msiquery.h
Library Msi.lib
DLL Msi.dll

另请参阅

安装程序选择函数