ICE 消息指南
ICE 自定义作通过调用 MsiProcessMessage 并发布INSTALLMESSAGE_USER类型消息进行通信。
为 ICE 自定义作创作消息字符串时,请按如下所示设置字符串的格式。
ICE<选项卡>“消息类型<”选项卡>“说明”选项卡<选项卡>帮助 URL 或位置<选项卡>“表名<”选项卡>“列名<”选项卡>主键<选项卡>主<键>主键。 . . (根据需要对任意数量的主键重复)
每个消息都需要字符串的前三个字段。
“消息类型”字段指定 ICE 是报告“失败”、“错误”、“警告”还是“信息性”消息。
价值 | 消息类型 |
---|---|
0 | 报告 ICE 自定义作失败的失败消息。 |
1 | 报告导致错误行为的数据库创作的错误消息。 |
2 | 在某些情况下导致错误行为的警告消息报告数据库创作。 警告还可以报告数据库创作的意外副作用。 |
3 | 信息性消息。 |
如果帮助不可用,则帮助 URL 字段可能是空字符串。
错误和警告消息应提供“表名称”、“列名”和“主键”字段。 如果省略这些字段中的任何一个,则第一个空白字段后面的所有字段都必须被排除在邮件中。 例如,在没有列名和主键或表名的情况下提供表名,并且没有主键提供列名。 但是,如果没有表名,则无法使用列名和主键。 可以列出多个主键,直到该表中的所有主键都已给定值。
例子
C++中示例 ICE 演示的第一条消息:
“ICE01\t3\tCreated 04/29/1998,<插入作者的名字在这里>。
示例 ICE 发布的第二条消息:
“ICE01\t3\tLast 修改了 1999/05/06/1999,<在此处插入作者的姓名>。
示例 ICE 发布的第三条消息。
“ICE01\t3\tSimple ICE,用于说明 ICE 概念”。