ICE 訊息指導方針
ICE 自訂動作會藉由呼叫 MsiProcessMessage 並張貼INSTALLMESSAGE_USER類型訊息來進行通訊。
為 ICE 自訂動作撰寫訊息字串時,請將字串格式化如下。
ICE< 的名稱索引標籤[訊息類型<> ] 索引 > 標籤[說明<>URL] 或 [位置<> ] 索引標籤 [資料表名稱]索引標籤 [資料行名稱<><> ] 索引標籤[主鍵] 索引標籤 [主鍵<>< ] 索引卷標 。 > . . (視需要重複執行多個主鍵)
每個訊息都需要字串的前三個欄位。
[訊息類型] 欄位會指定 ICE 報告 [失敗]、[錯誤]、[警告] 或 [資訊] 訊息。
值 | 訊息類型 |
---|---|
0 | 報告 ICE 自訂動作失敗的失敗訊息。 |
1 | 錯誤訊息報告造成不正確行為的資料庫撰寫。 |
2 | 在某些情況下造成不正確行為的警告訊息報告資料庫撰寫。 警告也可以報告資料庫撰寫的非預期副作用。 |
3 | 參考資訊。 |
如果無法使用說明,[說明 URL] 欄位可能是空字串。
錯誤和警告訊息應該提供 [資料表名稱]、[資料行名稱] 和 [主鍵] 欄位。 如果省略這些欄位,則第一個空白欄位後面的所有欄位都必須離開訊息。 例如,資料表名稱是以沒有資料行名稱和主鍵或資料表名稱提供,而且沒有主鍵提供資料行名稱。 不過,如果沒有資料表名稱,就無法使用資料行名稱和主鍵。 可以列出多個主鍵,直到該資料表中的所有主鍵都已指定值為止。
範例
C ++ 中的範例 ICE所說明的第一則訊息:
「ICE01\t3\tCreated 04/29/1998 by < insert author's name here > .
範例 ICE 所張貼的第二則訊息:
「ICE01\t3\tLast 已 > 在這裡插入 < 作者的名稱修改 05/06/1999。」
範例 ICE 所張貼的第三則訊息。
「ICE01\t3\tSimple ICE 以說明 ICE 概念」。