Richtlinien für ICE-Nachrichten

Benutzerdefinierte ICE-Aktionen kommunizieren, indem MsiProcessMessage aufgerufen und eine Nachricht vom Typ „INSTALLMESSAGE_USER“ ausgegeben wird.

Formatieren Sie beim Erstellen einer Nachrichtenzeichenfolge für eine benutzerdefinierte ICE-Aktion die Zeichenfolge wie folgt.

Name der ICE<Tabstopp>Nachrichtentyp<Tabstopp>Beschreibung<Tabstopp>Hilfe-URL oder -Speicherort<Tabstopp>Tabellenname<Tabstopp>Spaltenname<Tabstopp>Primärschlüssel<Tabstopp>Primärschlüssel<Tabstopp>Primärschlüssel. . . (Für so viele Primärschlüssel wie erforderlich wiederholen.)

Die ersten drei Felder der Zeichenfolge sind in jeder Nachricht erforderlich.

Das Feld „Nachrichtentyp“ (Message Type) gibt an, ob der ICE eine Fehlschlags-, Fehler-, Warn- oder Informationsmeldung meldet.

Wert	Nachrichtentyp
0	Fehlschlagsmeldung über das Fehlschlagen der benutzerdefinierten ICE-Aktion.
1	Fehlermeldung, die Vorgänge bei der Datenbankerstellung meldet, die zu falschem Verhalten führen.
2	Warnmeldung, die Vorgänge bei der Datenbankerstellung meldet, die in bestimmten Fällen zu falschem Verhalten führen. Warnungen können auch unerwartete Nebenwirkungen der Datenbankerstellung melden.
3	Informationsmeldung.

 

Wenn keine Hilfe verfügbar ist, ist das Feld „Hilfe-URL“ möglicherweise eine leere Zeichenfolge.

Fehler- und Warnmeldungen sollten die Felder „Tabellenname“, „Spaltenname“ und „Primärschlüssel“ enthalten. Wenn eins dieser Felder weggelassen wird, müssen alle Felder, die auf das erste leere Feld folgen, aus der Nachricht weggelassen werden. Beispielsweise wird ein Tabellenname ohne Spaltenname und Primärschlüssel bereitgestellt, oder ein Tabellenname und ein Spaltenname werden ohne Primärschlüssel bereitgestellt. Ein Spaltenname und Primärschlüssel können jedoch nicht ohne Tabellennamen verwendet werden. Mehrere Primärschlüssel können aufgelistet werden, bis alle Primärschlüssel in dieser Tabelle Werte erhalten haben.

Beispiele

Die erste Meldung, veranschaulicht durch das ICE-Beispiel in C++:

„ICE01\t3\tErstellt am 04/29/1998 von <Hier Namen des Autors einfügen>.“

Die zweite Nachricht, die vom ICE-Beispiel ausgegeben wird:

„ICE01\t3\tLetzte Änderung 05/06/1999 von <Hier Namen des Autors einfügen>.“

Die dritte Nachricht, die vom ICE-Beispiel ausgegeben wird.

„ICE01\t3\tEinfacher ICE zur Veranschaulichung des ICE-Konzepts.“