INSTALLUI_HANDLERA función de devolución de llamada (msi.h)
El prototipo de función INSTALLUI_HANDLER define una función de devolución de llamada que el instalador llama a mensajes de error y notificación de progreso. Para obtener más información sobre el uso de este prototipo de función, hay disponible un fragmento de código de ejemplo en Control de mensajes de progreso mediante MsiSetExternalUI.
Sintaxis
INSTALLUI_HANDLERA InstalluiHandlera;
int InstalluiHandlera(
LPVOID pvContext,
UINT iMessageType,
LPCSTR szMessage
)
{...}
Parámetros
pvContext
Puntero a un contexto de aplicación pasado a la función msiSetExternalUI de
iMessageType
Especifica una combinación de un estilo de cuadro de mensaje, un tipo de icono de cuadro de mensaje, un botón predeterminado y un tipo de mensaje de instalación. Este parámetro debe ser uno de los siguientes.
| Instalar tipos de mensajeFlag | Significado |
|---|---|
|
Terminación prematura |
|
Mensaje de error con formato |
|
Mensaje de advertencia con formato |
|
Mensaje de solicitud de usuario. |
|
Mensaje informativo para el registro |
|
Lista de archivos actualmente en uso que deben cerrarse antes de reemplazarse. |
|
Solicitud para determinar una ubicación de origen válida |
|
Lista de archivos actualmente en uso que deben cerrarse antes de reemplazarse. Disponible a partir de Windows Installer 4.0. Para obtener más información sobre este mensaje, vea Using Restart Manager with an External UI. |
|
Mensaje de espacio en disco insuficiente |
|
Inicio del mensaje de acción. Este mensaje incluye el nombre y la descripción de la acción. |
|
Datos con formato asociados al elemento de acción individual. |
|
Información del medidor de progreso. Este mensaje incluye información sobre las unidades hasta ahora y el número total de unidades. |
|
Información de diálogo con formato para la interfaz de usuario. |
|
Enviado antes de la inicialización de la interfaz de usuario, sin datos de cadena |
|
Enviado después de la finalización de la interfaz de usuario, sin datos de cadena |
|
Enviado antes de mostrar el cuadro de diálogo o el asistente creados |
|
Enviado antes de la instalación del producto. |
|
Enviado después de la instalación del producto. |
Se deben usar los valores predeterminados siguientes si falta alguno de los mensajes anteriores: MB_OK, sin icono ni MB_DEFBUTTON1. No hay ningún tipo de mensaje de instalación predeterminado; siempre se especifica un tipo de mensaje.
szMessage
Especifica el texto del mensaje.
Valor devuelto
Los siguientes valores devueltos se asignan a los botones especificados por el estilo del cuadro de mensaje:
IDOK
Observaciones
Para obtener más información sobre cómo devolver valores desde un controlador de interfaz de usuario externo, consulte el tema Devolver valores de un controlador de interfaz de usuario externo.
Nota
El encabezado msi.h define INSTALLUI_HANDLER como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Installer 5.0 en Windows Server 2012, Windows 8, Windows Server 2008 R2 o Windows 7. Windows Installer 4.0 o Windows Installer 4.5 en Windows Server 2008 o Windows Vista. Windows Installer en Windows Server 2003 o Windows XP |
| de la plataforma de destino de |
Windows |
| encabezado de |
msi.h |