数据库函数

  • 项目

本材料适用于编写自己的安装程序的开发人员，以及想要详细了解安装程序数据库表的开发人员。 有关安装程序的一般信息，请参阅关于 Windows Installer。

可以使用安装程序访问函数来访问数据库和安装过程。 这些函数只能由自定义安装操作和创作工具使用。 某些安装程序访问函数需要使用 SQL 查询字符串来查询数据库。 查询必须遵守安装程序的 SQL 语法。

本主题按类别列出安装程序数据库访问函数。

常规数据库访问函数

函数 说明
MsiDatabaseCommit 将更改提交到数据库。
MsiDatabaseGetPrimaryKeys 返回所有主键列的名称。
MsiDatabaseIsTablePersistent 返回描述表状态的枚举。
MsiDatabaseOpenView 准备数据库查询并创建视图对象。
MsiGetActiveDatabase 返回安装的活动数据库。
MsiViewGetColumnInfo 返回列名或定义。
MsiOpenDatabase 打开数据库文件进行数据访问。
MsiViewClose 释放已执行的视图的结果集。
MsiViewExecute 执行视图查询并提供必需的参数。
MsiViewFetch 从视图中提取下一条顺序记录。
MsiViewGetError 返回 MsiViewModify 函数中发生的错误。
MsiViewModify 更新提取的记录。

 

数据库管理函数

函数 说明
MsiCreateTransformSummaryInfo 为现有转换创建摘要信息。
MsiDatabaseApplyTransform 将转换应用于数据库。
MsiDatabaseExport 将打开的数据库中的表导出到文本存档文件。
MsiDatabaseGenerateTransform 生成两个数据库之间的差异的转换文件。
MsiDatabaseImport 将安装程序文本存档表导入到打开的数据库。
MsiDatabaseMerge 将两个数据库合并到一起。
MsiGetDatabaseState 返回数据库的状态。

 

记录处理函数

函数 说明
MsiCreateRecord 创建包含指定数量的字段的新记录对象。
MsiFormatRecord 使用格式字符串设置记录字段数据和属性的格式。
MsiRecordClearData 将记录中的所有字段设置为 null。
MsiRecordDataSize 返回记录字段的长度。
MsiRecordGetFieldCount 返回记录中的字段数。
MsiRecordGetInteger 返回记录字段中的整数值。
MsiRecordGetString 返回记录字段的字符串值。
MsiRecordIsNull 报告记录字段是否为 null。
MsiRecordReadStream 将记录流字段中的字节读入缓冲区。
MsiRecordSetInteger 将记录字段设置为整数字段。
MsiRecordSetStream 设置文件中的记录流字段。
MsiRecordSetString 将字符串复制到指定的字段中。

 

摘要信息属性函数

函数 说明
MsiGetSummaryInformation 获取安装程序数据库的摘要信息流的句柄。
MsiSummaryInfoGetProperty 从摘要信息中获取单个属性。
MsiSummaryInfoGetPropertyCount 返回摘要信息流中的属性数。
MsiSummaryInfoPersist 将已更改的摘要信息写回到摘要信息流。
MsiSummaryInfoSetProperty 设置单个摘要信息属性。

 

安装程序状态访问函数

函数 说明
MsiGetLanguage 返回当前安装的数字语言。
MsiGetLastErrorRecord 返回上次为调用进程返回的错误记录。
MsiGetMode 返回布尔内部安装状态之一。
MsiGetProperty 获取安装程序属性的值。
MsiSetProperty 设置安装属性的值。
MsiSetMode 设置内部引擎布尔状态。

 

安装程序操作函数

函数 说明
MsiDoAction 执行内置操作、自定义操作或用户界面向导操作。
MsiEvaluateCondition 计算包含属性名称和值的条件表达式。
MsiProcessMessage 将错误记录发送到安装程序进行处理。
MsiSequence 执行操作序列。

 

安装程序位置函数

函数 说明
MsiGetSourcePath 返回 Directory 表中文件夹的完整源路径。
MsiGetTargetPath 返回 Directory 表中文件夹的完整目标路径。
MsiSetTargetPath 设置 Directory 表中文件夹的完整目标路径。

 

安装程序选择函数

函数 说明
MsiEnumComponentCosts 枚举安装某个组件所需的每个驱动器的磁盘空间。
MsiGetComponentState 获取组件的状态。
MsiGetFeatureCost 返回功能所需的磁盘空间。
MsiGetFeatureState 获取功能的状态。
MsiGetFeatureValidStates 返回有效的安装状态。
MsiSetComponentState 将组件设置为指定状态。
MsiSetFeatureAttributes 在运行时修改功能的默认属性。
MsiSetFeatureState 将功能设置为指定状态。
MsiSetInstallLevel 设置完整产品安装的安装级别。
MsiVerifyDiskSpace 检查是否有足够的磁盘空间。

 

用户界面函数

函数 说明
MsiEnableUIPreview 启用用户界面的预览模式。
MsiPreviewBillboard 在显示的对话框中显示包含主机控件的标牌。
MsiPreviewDialog 以无模式和非活动状态显示对话框。

 

所有函数都支持 ANSI 和 Unicode 调用。 若要使用这些函数，请包含 MsiQuery.h 并与 Msi.lib 链接。

安装函数

除了上面列出的数据库访问函数之外，还可以使用安装程序函数参考部分中列出的安装程序函数来为应用程序创建安装包。