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

另请参阅

数据库函数

记录处理函数