ICE 消息指南

  • 项目

ICE 自定义操作通过调用 MsiProcessMessage 并发布 INSTALLMESSAGE_USER 类型消息进行通信。

为 ICE 自定义操作创作消息字符串时，请按如下所示格式设置字符串的格式。

ICE 名称<tab>消息类型<tab>说明<tab>帮助 URL 或位置<tab>表名<tab>列名<tab>主键<tab>主键<tab>主键 . . . （根据需要为任意数量的主键重复此格式）

每条消息都需要字符串的前三个字段。

“消息类型”字段指定 ICE 是报告“失败”、“错误”、“警告”还是“信息”消息。

值 消息类型
0 失败消息，报告 ICE 自定义操作失败。
1 错误消息，报告导致错误行为的数据库创作。
2 警告消息，报告在某些情况下会导致错误行为的数据库创作。 警告还可能报告数据库创作的意外副作用。
3 信息性消息。

 

如果帮助不可用，则“帮助 URL”字段可能是空字符串。

错误和警告消息应提供“表名”、“列名”和“主键”字段。 如果省略这些字段中的任何字段，则必须将第一个空白字段后面的所有字段从消息中移除。 例如，提供的表名没有列名和主键，或者提供的表名和列名没有主键。 但是，如果没有表名，就不能使用列名和主键。 可以列出多个主键，直到该表中的所有主键都被赋予值。

示例

C++ 示例 ICE 演示的第一条消息：

“ICE01\t3\t创建于 1998/04/29，作者为 <在此处插入作者姓名>。”

示例 ICE 发布的第二条消息：

“ICE01\t3\t最后一次修改于 1999/05/06，修改者为 <在此处插入作者姓名>。”

示例 ICE 发布的第三条消息。

“ICE01\t3\t简单的 ICE，用于演示 ICE 概念”。