Condividi tramite

Restituzione di messaggi di errore da azioni personalizzate

  • Articolo

Questa sezione descrive come inviare messaggi da azioni personalizzate che eseguono effettivamente una parte dell'installazione chiamando una libreria o uno script di collegamento dinamico. Si noti che tipo di azione personalizzato 19 invia solo un messaggio di errore specificato, restituisce un errore e quindi termina l'installazione. Il tipo di azione personalizzato 19 non esegue alcuna parte dell'installazione.

Per inviare un messaggio di errore da un'azione personalizzata che utilizza una libreria a collegamento dinamico (DLL), l'azione personalizzata deve chiamare MsiProcessMessage. Si noti che le azioni personalizzate avviate da un DoAction ControlEvent possono inviare messaggi con il metodo Message, ma non possono inviare un messaggio con MsiProcessMessage. Nei sistemi precedenti a Windows Server 2003, le azioni personalizzate avviate da un evento di controllo DoAction non possono inviare messaggi con il metodo MsiProcessMessage o Message. Per altre informazioni, vedere Invio di messaggi a Windows Installer tramite MsiProcessMessage.

Per visualizzare un messaggio di errore dall'interno di un'azione personalizzata usando una DLL

  1. L'azione personalizzata deve chiamare MsiProcessMessage e passare i parametri hInstall, eMessageTypee hRecord. L'handle per l'installazione, Tipo di Azione Personalizzata 19, può essere fornito all'azione personalizzata come descritto in Accesso alla sessione dell'installatore corrente dall'interno di un'azione personalizzata o da MsiOpenProduct o MsiOpenPackage.
  2. Il parametro eMessageType deve specificare uno dei tipi di messaggio elencati in MsiProcessMessage.
  3. Il parametro hRecord della funzioneMsiProcessMessagedipende dal tipo di messaggio. Vedere l'invio di messaggi a Windows Installer tramite MsiProcessMessage. Se il messaggio contiene dati formattati, immettere il messaggio nella tabella Errore usando la formattazione descritta in Formattato.

Per inviare un messaggio di errore da un'azione personalizzata che utilizza Script, l'azione personalizzata può chiamare il metodo Message dell'oggetto Session.

Per visualizzare un messaggio di errore dall'interno di un'azione personalizzata tramite script

  1. L'azione personalizzata deve chiamare il metodo dell'oggetto e passare i parametri kind e record.
  2. Il parametro tipo deve specificare uno dei tipi di messaggio elencati nel metodo.
  3. Il parametro del record del metododel messaggiodipende dal tipo di messaggio. Se il messaggio contiene dati formattati, immettere il messaggio nella tabella Errore usando la formattazione descritta in Formattato.

Le azioni personalizzate che usano file eseguibili non possono inviare un messaggio chiamando MsiProcessMessage o il metodo Message perché non possono ottenere un handle per l'installazione.

Valori Restituiti dell'Azione Personalizzata