msiquery.h) (MsiGetMode 函数

MsiGetMode 函数用于确定安装程序当前是否在表中列出的指定模式下运行。 函数返回 TRUEFALSE 的布尔值,指示传入函数的特定属性当前是否设置为 (TRUE) ) (FALSE) 。

语法

BOOL MsiGetMode(
  [in] MSIHANDLE  hInstall,
  [in] MSIRUNMODE eRunMode
);

parameters

[in] hInstall

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

[in] eRunMode

指定运行模式。 此参数必须具有以下值之一。

含义
MSIRUNMODE_ADMIN
管理模式正在安装,或产品正在安装。
MSIRUNMODE_ADVERTISE
播发正在安装,或者产品正在安装或更新。
MSIRUNMODE_MAINTENANCE
正在修改现有安装或有新安装。
MSIRUNMODE_ROLLBACKENABLED
回退已启用。
MSIRUNMODE_LOGENABLED
日志文件处于活动状态。 它是在安装会话之前启用的。
MSIRUNMODE_OPERATIONS
执行操作处于确定阶段。
MSIRUNMODE_REBOOTATEND
成功安装 (可设置) 后,必须重新启动。
MSIRUNMODE_REBOOTNOW
需要重新启动才能继续安装 (可设置) 。
MSIRUNMODE_CABINET
正在安装来自文件柜和 媒体表 文件的文件。
MSIRUNMODE_SOURCESHORTNAMES
源 LongFileNames 通过PID_MSISOURCE摘要属性禁止显示。
MSIRUNMODE_TARGETSHORTNAMES
通过 SHORTFILENAMES 属性禁止目标 LongFileNames
MSIRUNMODE_RESERVED11
保留供将来使用。
MSIRUNMODE_WINDOWS9X
操作系统是 9x 版本。
MSIRUNMODE_ZAWENABLED
操作系统支持需求安装。
MSIRUNMODE_RESERVED14
保留供将来使用。
MSIRUNMODE_RESERVED15
保留供将来使用。
MSIRUNMODE_SCHEDULED
从安装脚本执行调用的自定义操作。
MSIRUNMODE_ROLLBACK
从回滚执行脚本调用的自定义操作。
MSIRUNMODE_COMMIT
从提交执行脚本调用的自定义操作。

返回值

TRUE 表示当前已设置传递到函数的特定属性。

FALSE 表示当前未设置传递到函数的特定属性。

注解

请注意,从延迟的自定义操作调用 MsiGetMode 时,并非所有 iRunMode 的运行模式值都可用。 有关详细信息,请参阅 获取延迟执行自定义操作的上下文信息

要求

   
最低受支持的客户端 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

请参阅

安装程序状态访问函数