Función MsiSetInstallLevel (msiquery.h)

  • Artículo

La función MsiSetInstallLevel establece el nivel de instalación de una instalación completa del producto.

Sintaxis

UINT MsiSetInstallLevel(
  [in] MSIHANDLE hInstall,
  [in] int       iInstallLevel
);

Parámetros

[in] hInstall

Controla la instalación que se proporciona a una acción personalizada de DLL o se obtiene mediante MsiOpenPackage, MsiOpenPackageEx o MsiOpenProduct.

[in] iInstallLevel

Nivel de instalación.

Valor devuelto

La función MsiSetInstallLevel devuelve uno de los siguientes valores:

Comentarios

La función MsiSetInstallLevel establece lo siguiente:

  • Nivel de instalación de la instalación actual en un valor especificado.
  • Estados Seleccionar e Instalados para todas las características de la tabla Característica.
  • El estado Acción de cada componente de la tabla Componente, en función del nuevo nivel.
Para cualquier instalación, hay un nivel de instalación definido, que es un valor entero de 1 a 32 767. El valor inicial viene determinado por la propiedad INSTALLLEVEL , que se establece en la tabla de propiedades.

Si se pasa 0 (cero) o un número negativo en el parámetro iInstallLevel , el nivel de instalación actual no cambia, pero todas las características se siguen actualizando en función del nivel de instalación actual. Para obtener más información, vea Llamar a funciones de base de datos desde programas.

Si se produce un error en la función, puede obtener información de error extendida mediante MsiGetLastErrorRecord.

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 en Windows Server 2003 o Windows XP
Plataforma de destino Windows
Encabezado msiquery.h
Library Msi.lib
Archivo DLL Msi.dll

Consulte también

Funciones de selección del instalador