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 概念”。