Diretrizes de mensagem de ICE
As ações personalizadas de ICE estabelecem comunicação MsiProcessMessage e publicando uma mensagem do tipo INSTALLMESSAGE_USER.
Ao criar uma cadeia de mensagem para uma ação personalizada de ICE, formate a cadeia de caracteres conforme a seguir.
Nome do ICE<tab>Tipo de mensagem<tab>Descrição<tab>Localização ou URL da ajuda<tab>Nome da tabela<tab>Nome da coluna<tab>Chave primária<tab>Chave primária<tab>Chave primária . . . (repita para quantas chaves primárias forem necessárias)
Os três primeiros campos da cadeia de caracteres são obrigatórios em todas as mensagens.
O campo do Tipo de Mensagem especifica se o ICE relata uma mensagem de falha, de erro, de aviso ou informativa.
| Valor | Tipo de mensagem |
|---|---|
| 0 | Mensagem de falha relatando a falha da ação personalizada do ICE. |
| 1 | Criação do banco de dados de relatório de mensagem de erro que causa comportamento incorreto. |
| 2 | Mensagem de aviso relatando a criação do banco de dados que causa comportamento incorreto em determinados casos. Os avisos também podem relatar efeitos colaterais inesperados da criação de banco de dados. |
| 3 | Mensagem informativa. |
Se a ajuda não estiver disponível, o campo da URL da Ajuda poderá ser uma cadeia de caracteres vazia.
As mensagens de erro e de aviso devem fornecer os campos de Nome da Tabela, Nome da Coluna e Chave Primária. Se algum desses campos for omitido, todos os campos após o primeiro campo em branco deverão ser deixados de fora da mensagem. Por exemplo, um nome de tabela é fornecido sem um nome de coluna e chaves primárias ou um nome de tabela e um nome de coluna é fornecido sem chaves primárias. No entanto, um nome de coluna e de chaves primárias não podem ser usados sem um nome de tabela. Várias chaves primárias podem ser listadas até que todas as chaves primárias nessa tabela tenham recebido valores.
Exemplos
A primeira mensagem ilustrada pelo ICE de exemplo em C++:
"ICE01\t3\tCreated 29/04/1998 inserindo <o nome do autor aqui>."
A segunda mensagem publicada pelo ICE de exemplo:
"ICE01\t3\tLast modificado em 06/05/1999 por <insira o nome do autor aqui>."
A terceira mensagem publicada pelo ICE de exemplo.
"ICE01\t3\tSimple ICE para ilustrar o conceito de ICE".