La función MsiSetInternalUI habilita la interfaz de usuario interna del instalador. A continuación, esta interfaz de usuario se usa para todas las llamadas posteriores a las funciones del instalador que generan la interfaz de usuario en este proceso. Para más información, consulte Niveles de interfaz de usuario.
Especifica el nivel de complejidad de la interfaz de usuario. Este parámetro puede ser uno de los valores siguientes.
Valor
Significado
INSTALLUILEVEL_FULL
Interfaz de usuario creadas con asistentes, progreso y errores.
INSTALLUILEVEL_REDUCED
Interfaz de usuario creadas con cuadros de diálogo del asistente suprimidos.
INSTALLUILEVEL_BASIC
Progreso simple y control de errores.
INSTALLUILEVEL_DEFAULT
El instalador elige un nivel de interfaz de usuario adecuado.
INSTALLUILEVEL_NONE
Instalación totalmente silenciosa. Esto incluye suprimir el aviso de elevación incluso si es necesario. Consulte INSTALLUILEVEL_UACONLY si desea que el usuario pueda elevarlo.
INSTALLUILEVEL_ENDDIALOG
Si se combina con cualquier valor anterior, el instalador muestra un cuadro de diálogo modal al final de una instalación correcta o si se ha producido un error. No se muestra ningún cuadro de diálogo modal si el usuario cancela la operación.
INSTALLUILEVEL_PROGRESSONLY
Si se combina con el valor de INSTALLUILEVEL_BASIC , el instalador muestra cuadros de diálogo de progreso simples, pero no muestra cuadros de diálogo modales ni cuadros de diálogo de error.
INSTALLUILEVEL_NOCHANGE
No hay ningún cambio en el nivel de interfaz de usuario. Sin embargo, si phWnd no es Null, la ventana primaria puede cambiar.
INSTALLUILEVEL_HIDECANCEL
Si se combina con el valor de INSTALLUILEVEL_BASIC , el instalador muestra cuadros de diálogo de progreso simples, pero no muestra un botón Cancelar en el cuadro de diálogo. Esto impide que los usuarios cancelen la instalación.
INSTALLUILEVEL_SOURCERESONLY
Si este valor se combina con el valor de INSTALLUILEVEL_NONE , el instalador muestra solo los cuadros de diálogo usados para la resolución de origen. No se muestran otros cuadros de diálogo. Este valor no tiene ningún efecto si el nivel de interfaz de usuario no es INSTALLUILEVEL_NONE. Se usa con una interfaz de usuario externa diseñada para controlar toda la interfaz de usuario, excepto la resolución de origen. En este caso, el instalador controla la resolución de origen.
INSTALLUILEVEL_UACONLY
Si se combina con el valor de INSTALLUILEVEL_NONE , la instalación será completamente silenciosa, excepto la petición de elevación si es necesario.
[in, out] phWnd
Puntero a una ventana. Esta ventana se convierte en el propietario de cualquier interfaz de usuario creada. Se devuelve un puntero al propietario anterior de la interfaz de usuario. Si este parámetro es null, el propietario de la interfaz de usuario no cambia.
Valor devuelto
Se devuelve el nivel de interfaz de usuario anterior. Si se pasa un dwUILevel no válido, se devuelve INSTALLUILEVEL_NOCHANGE .
Comentarios
La función MsiSetInternalUI es útil cuando el instalador debe mostrar una interfaz de usuario. Por ejemplo, si se instala una característica, pero el origen es un disco compacto que se debe insertar, el instalador solicita al usuario el disco compacto. Según la naturaleza de la instalación, la aplicación también puede mostrar indicadores de progreso o consultar al usuario para obtener información.
Cuando se carga Msi.dll, el nivel de interfaz de usuario se establece en DEFAULT y el propietario de la interfaz de usuario se establece en 0 (es decir, el propietario inicial de la interfaz de usuario es el escritorio).
Requisitos
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. Consulte Requisitos de Windows Installer en tiempo de ejecución para obtener información sobre el Service Pack mínimo de Windows que requiere una versión de Windows Installer.