Devolución de mensajes de error de acciones personalizadas

En esta sección se describe cómo enviar mensajes de acciones personalizadas que realizan realmente una parte de la instalación mediante una llamada a una biblioteca de vínculos dinámicos o un script. Tenga en cuenta que el tipo de acción personalizada 19 solo envía un mensaje de error especificado, devuelve un error y, a continuación, finaliza la instalación. El tipo de acción personalizada 19 no realiza ninguna parte de la instalación.

Para enviar un mensaje de error desde una acción personalizada que usa una biblioteca de vínculos dinámicos (DLL), haga que la acción personalizada llame a MsiProcessMessage. Tenga en cuenta que las acciones personalizadas iniciadas por un ControlEvent DoAction pueden enviar mensajes con el método Message, pero no pueden enviar un mensaje con MsiProcessMessage. En sistemas anteriores a Windows Server 2003, las acciones personalizadas iniciadas por un DoAction ControlEvent no pueden enviar mensajes con MsiProcessMessage o el método Message. Para obtener más información, vea Envío de mensajes a Windows Installer mediante MsiProcessMessage.

Mostrar un mensaje de error desde una acción personalizada mediante un archivo DLL

1. La acción personalizada debe llamar a MsiProcessMessage y pasar los parámetros hInstall, eMessageType y hRecord. El identificador de la instalación, el tipo de acción personalizada 19, se puede proporcionar a la acción personalizada como se describe en Acceso a la sesión del instalador actual desde dentro de una acción personalizada o desde MsiOpenProduct o MsiOpenPackage.
2. El parámetro eMessageType debe especificar uno de los tipos de mensaje como se muestra en MsiProcessMessage.
3. El parámetro hRecord de la función MsiProcessMessage depende del tipo de mensaje. Consulte Envío de mensajes a Windows Installer con MsiProcessMessage. Si el mensaje contiene datos con formato, escriba el mensaje en la tabla Error con el formato descrito en Formatted.

Para enviar un mensaje de error desde una acción personalizada que usa Scripts, la acción personalizada puede llamar al método Message del objeto Session.

Mostrar un mensaje de error desde dentro de una acción personalizada mediante script

1. La acción personalizada debe llamar al método Message del objeto Session y pasar los parámetros kind y record.
2. El parámetro kind debe especificar uno de los tipos de mensaje enumerados en el método Message.
3. El parámetro record del método Message depende del tipo de mensaje. Si el mensaje contiene datos con formato, escriba el mensaje en la tabla Error con el formato descrito en Formatted.

Las acciones personalizadas que usan archivos ejecutables no pueden enviar un mensaje llamando a MsiProcessMessage o al método Message porque no pueden obtener un identificador para la instalación.

Temas relacionados

Valores devueltos de acción personalizada