Compartir a través de

Función MsiSetInternalUI (msi.h)

  • Artículo

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.

Sintaxis

INSTALLUILEVEL MsiSetInternalUI(
  [in]      INSTALLUILEVEL dwUILevel,
  [in, out] HWND           *phWnd
);

Parámetros

[in] dwUILevel

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.
Plataforma de destino Windows
Encabezado msi.h
Library Msi.lib
Archivo DLL Msi.dll

Consulte también

Funciones de interfaz y registro