Linee guida per i messaggi ICE
Le azioni personalizzate ICE comunicano chiamando MsiProcessMessage e pubblicando un messaggio di tipo INSTALLMESSAGE_USER.
Quando si crea una stringa di messaggio per un'azione personalizzata ICE, formattare la stringa come indicato di seguito.
Nome di ICE<>schedaTipo di<> messaggio SchedaDescrizione<> URL guida o><><scheda Nome tabella Nome tabella SchedaNome<> colonna scheda Chiaveprimaria<<>> Chiaveprimaria chiave primaria. . . (ripetere per il numero di chiavi primarie necessarie)
I primi tre campi della stringa sono necessari in ogni messaggio.
Il campo Tipo di messaggio specifica se l'ICE segnala un messaggio di errore, errore, avviso o informazioni.
| Valore | Tipo di messaggio |
|---|---|
| 0 | Messaggio di errore che segnala l'errore dell'azione personalizzata ICE. |
| 1 | Creazione del database di report dei messaggi di errore che causano un comportamento non corretto. |
| 2 | Creazione del database di report dei messaggi di avviso che causa un comportamento non corretto in determinati casi. Gli avvisi possono anche segnalare effetti collaterali imprevisti della creazione del database. |
| 3 | Messaggio informativo. |
Se la Guida non è disponibile, il campo URL della Guida può essere la stringa vuota.
I messaggi di errore e avviso devono fornire i campi Nome tabella, Nome colonna e Chiave primaria. Se uno di questi campi viene omesso, tutti i campi che seguono il primo campo vuoto devono essere lasciati fuori dal messaggio. Ad esempio, un nome di tabella viene fornito senza un nome di colonna e chiavi primarie o un nome di tabella e un nome di colonna viene fornito senza chiavi primarie. Tuttavia, non è possibile usare un nome di colonna e chiavi primarie senza un nome di tabella. Più chiavi primarie possono essere elencate fino a quando non sono state fornite tutte le chiavi primarie in tale tabella.
Esempio
Il primo messaggio illustrato dall'ice di esempio in C++:
"ICE01\t3\tCreated 04/29/1998 by <insert author's name here>".
Il secondo messaggio pubblicato dall'esempio ICE:
"ICE01\t3\tLast modificato 05/06/1999 per <inserire il nome dell'autore qui>."
Il terzo messaggio inviato dall'ice di esempio.
"ICE01\t3\tSimple ICE per illustrare il concetto ICE".