Restituzione di messaggi di errore da azioni personalizzate

  • Articolo

Questa sezione descrive come inviare messaggi da azioni personalizzate che effettivamente eseguono una parte dell'installazione chiamando una libreria di collegamento dinamica o uno script. Si noti che il 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 usa una libreria di collegamento dinamico (DLL), avere la chiamata di azione personalizzata MsiProcessMessage. Si noti che le azioni personalizzate avviate da un controllo 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 controllo DoActionEvent non possono inviare messaggi con msiProcessMessage o metodo 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, eMessageType e hRecord. L'handle per l'installazione, tipo di azione personalizzato 19, può essere fornito all'azione personalizzata, come descritto in Accesso alla sessione del programma di installazione 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 funzione MsiProcessMessage dipende dal tipo di messaggio. Vedere 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 usa 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 Message dell'oggetto Session e passare il tipo di parametri e il record.
  2. Il tipo di parametro deve specificare uno dei tipi di messaggio elencati nel metodo Message .
  3. Il parametro record del metodo Message dipende 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 dall'azione personalizzata