MsiSequenceW 函数 (msiquery.h)
MsiSequence 函数执行另一个操作序列,如指定表中所述。
语法
UINT MsiSequenceW(
[in] MSIHANDLE hInstall,
[in] LPCWSTR szTable,
[in] INT iSequenceMode
);
参数
[in] hInstall
提供给 DLL 自定义操作或通过 MsiOpenPackage、MsiOpenPackageEx 或 MsiOpenProduct 获取的安装的句柄。
[in] szTable
指定包含操作序列的表的名称。
[in] iSequenceMode
此参数当前未实现。 它保留供将来使用,并且必须为 0。
返回值
此函数返回 UINT。
注解
MsiSequence 函数查询指定的表,按 Sequence 列中的数字对操作进行排序。 对于检索到的每一行,执行一个操作,前提是提供的任何条件表达式的计算结果不为 FALSE。
无法通过调用 MsiSequence 来运行包含任何更新系统操作的操作序列,例如 InstallFiles 和 WriteRegistryValues 操作。 此规则的例外情况是,如果从 InstallExecuteSequence 表中在 InstallInitialize 和 InstallFinalize 操作之间计划的自定义操作调用 MsiSequence。 可以调用不更新系统的操作,例如 AppSearch 或 CostInitialize。
注意
msiquery.h 标头将 MsiSequence 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 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 |