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

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

值 含义
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

请参阅

安装程序状态访问函数