INSTALLUI_HANDLER_RECORD función de devolución de llamada (msi.h)

  • Artículo

El prototipo de función INSTALLUI_HANDLER_RECORD define una función de devolución de llamada que el instalador llama a mensajes de error y notificación de progreso. Llame a la función MsiSetExternalUIRecord para habilitar un controlador externo de interfaz de usuario (UI) externa de registro.

Windows Installer 3.0 y Windows Installer 2.0: No se admite. Disponible a partir de Windows Installer versión 3.1 y posteriores.

Sintaxis

INSTALLUI_HANDLER_RECORD InstalluiHandlerRecord;

int InstalluiHandlerRecord(
  LPVOID pvContext,
  UINT iMessageType,
  MSIHANDLE hRecord
)
{...}

Parámetros

pvContext

Puntero a un contexto de aplicación pasado a la función MsiSetExternalUIRecord . Este parámetro se puede usar para la comprobación de errores.

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.

Estilos del cuadro de mensajeFlag Significado
MB_ABORTRETRYIGNORE
 El cuadro de mensaje contiene los botones Anular, Reintentar e Omitir .
MB_OK
 El cuadro de mensaje contiene el botón Aceptar . Este es el valor predeterminado.
MB_OKCANCEL
 El cuadro de mensaje contiene los botones Aceptar y Cancelar .
MB_RETRYCANCEL
 El cuadro de mensaje contiene los botones Reintentar y Cancelar .
MB_YESNO
 El cuadro de mensaje contiene los botones Sí y No .
MB_YESNOCANCEL
 El cuadro de mensaje contiene los botones Sí, No y Cancelar .
 
Cuadro de mensaje IconTypesFlag Significado
MB_ICONEXCLAMATION, MB_ICONWARNING
 Aparece un signo de exclamación en el cuadro de mensaje.
MB_ICONINFORMATION, MB_ICONASTERISK
 El signo de información aparece en el cuadro de mensaje.
MB_ICONQUESTION
 Aparece un signo de interrogación en el cuadro de mensaje.
MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND
 Aparece un signo de detención en el cuadro de mensaje.
 
Botones predeterminadosFlag Significado
MB_DEFBUTTON1
 El primer botón es el predeterminado.
MB_DEFBUTTON2
 El segundo botón es el predeterminado.
MB_DEFBUTTON3
 El tercer botón es el predeterminado.
 
Instalar message TypesFlag Significado
INSTALLMESSAGE_FATALEXIT
 Terminación prematura
INSTALLMESSAGE_ERROR
 Mensaje de error con formato
INSTALLMESSAGE_WARNING
 Mensaje de advertencia con formato
INSTALLMESSAGE_USER
 Mensaje de solicitud de usuario.
INSTALLMESSAGE_INFO
 Mensaje informativo para el registro
INSTALLMESSAGE_FILESINUSE
 Lista de archivos actualmente en uso que deben cerrarse antes de reemplazarse
INSTALLMESSAGE_RESOLVESOURCE
 Solicitud para determinar una ubicación de origen válida
INSTALLMESSAGE_RMFILESINUSE
 Lista de archivos actualmente en uso que deben cerrarse antes de reemplazarse. Disponible a partir de la versión 4.0 de Windows Installer. Para obtener más información sobre este mensaje, vea Uso del Administrador de reinicio con una interfaz de usuario externa.
INSTALLMESSAGE_OUTOFDISKSPACE
 Mensaje de espacio en disco insuficiente
INSTALLMESSAGE_ACTIONSTART
 Inicio del mensaje de acción. Este mensaje incluye el nombre y la descripción de la acción.
INSTALLMESSAGE_ACTIONDATA
 Datos con formato asociados al elemento de acción individual.
INSTALLMESSAGE_PROGRESS
 Información del medidor de progreso. Este mensaje incluye información sobre las unidades hasta ahora y el número total de unidades.
INSTALLMESSAGE_COMMONDATA
 Información de cuadro de diálogo con formato para la interfaz de usuario.
INSTALLMESSAGE_INITIALIZE
 Enviado antes de la inicialización de la interfaz de usuario, sin datos de cadena
INSTALLMESSAGE_TERMINATE
 Enviado después de la finalización de la interfaz de usuario, sin datos de cadena
INSTALLMESSAGE_SHOWDIALOG
 Se envió antes de mostrar el cuadro de diálogo o el asistente creados.
INSTALLMESSAGE_INSTALLSTART
 Enviado antes de la instalación del producto.
INSTALLMESSAGE_INSTALLEND
 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 y MB_DEFBUTTON1. No hay ningún tipo de mensaje de instalación predeterminado; Siempre se especifica un tipo de mensaje.

hRecord

Especifica un identificador para el objeto de registro. Para obtener información sobre los objetos de registro, vea Funciones de procesamiento de registros.

Valor devuelto

Los siguientes valores devueltos se asignan a los botones especificados por el estilo del cuadro de mensaje:

IDOK

 
IDCANCEL
 
IDABORT
 
IDRETRY
 
IDIGNORE
 
IDYES
 
IDNO

Comentarios

Este tipo de controlador de interfaz de usuario externo se debe usar cuando se conoce el tipo de errores o mensajes en los que está interesado el autor de la llamada y quiere evitar la sobrecarga de analizar el mensaje de cadena que se envía a un controlador de interfaz de usuario externo de INSTALLUI_HANDLER tipo, pero recuperar los datos de interés de los campos de hRecord.

Para obtener más información sobre cómo devolver valores de un controlador de interfaz de usuario externo, vea el tema Devolver valores de un controlador de interfaz de usuario externo . El objeto hRecord enviado al controlador de interfaz de usuario externo basado en registros es propiedad de Windows Installer y solo es válido para la duración de la devolución de llamada. La devolución de llamada debe extraer del registro los datos que necesite y no debe cerrar ese identificador.

Windows Installer omitirá cualquier intento por parte de un controlador de interfaz de usuario externo basado en registros para modificar los datos del objeto hRecord.

Para obtener más información sobre el uso de un controlador externo basado en registros, consulte Supervisión de una instalación mediante MsiSetExternalUIRecord.

Requisitos

Requisito Value
Cliente mínimo compatible 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 3.1 en Windows Server 2003 o Windows XP.
Plataforma de destino Windows
Encabezado msi.h

Consulte también

MsiSetExternalUI

No se admite en Windows Installer 3.0 ni en versiones anteriores