msiquery.h) (MsiCreateRecord 函数
MsiCreateRecord 函数使用指定数量的字段创建一个新的记录对象。 此函数返回应使用 MsiCloseHandle 关闭的句柄。
语法
MSIHANDLE MsiCreateRecord(
[in] UINT cParams
);
参数
[in] cParams
指定记录将具有的字段数。 记录中字段的最大数目限制为 65535。
返回值
如果函数成功,则返回值是新记录对象的句柄。
如果函数失败,则返回值为 null。
注解
由 MsiCreateRecord 函数创建的记录对象的字段 0 用于格式字符串和操作代码,并且不包括在 cParams 指定的计数中。 所有字段都初始化为 null。
请注意,建议使用 PMSIHANDLE 类型的变量,因为安装程序在 PMSIHANDLE 对象超出范围时会关闭它们,而必须通过调用 MsiCloseHandle 关闭 MSIHANDLE 对象。 有关详细信息,请参阅 Windows Installer 最佳做法中的使用 PMSIHANDLE 而非 HANDLE 部分。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 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 |