msiquery.h) (MsiGetMode 函数
MsiGetMode 函数用于确定安装程序当前是否在表中列出的指定模式下运行。 函数返回 TRUE 或 FALSE 的布尔值,指示传入函数的特定属性当前是否设置为 (TRUE) ) (FALSE) 。
语法
BOOL MsiGetMode(
[in] MSIHANDLE hInstall,
[in] MSIRUNMODE eRunMode
);
parameters
[in] hInstall
提供给 DLL 自定义操作或通过 MsiOpenPackage、MsiOpenPackageEx 或 MsiOpenProduct 获取的安装的句柄。
[in] eRunMode
指定运行模式。 此参数必须具有以下值之一。
值 | 含义 |
---|---|
|
管理模式正在安装,或产品正在安装。 |
|
播发正在安装,或者产品正在安装或更新。 |
|
正在修改现有安装或有新安装。 |
|
回退已启用。 |
|
日志文件处于活动状态。 它是在安装会话之前启用的。 |
|
执行操作处于确定阶段。 |
|
成功安装 (可设置) 后,必须重新启动。 |
|
需要重新启动才能继续安装 (可设置) 。 |
|
正在安装来自文件柜和 媒体表 文件的文件。 |
|
源 LongFileNames 通过PID_MSISOURCE摘要属性禁止显示。 |
|
通过 SHORTFILENAMES 属性禁止目标 LongFileNames 。 |
|
保留供将来使用。 |
|
操作系统是 9x 版本。 |
|
操作系统支持需求安装。 |
|
保留供将来使用。 |
|
保留供将来使用。 |
|
从安装脚本执行调用的自定义操作。 |
|
从回滚执行脚本调用的自定义操作。 |
|
从提交执行脚本调用的自定义操作。 |
返回值
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 |