MsiSetInstallLevel, fonction (msiquery.h)

La fonction MsiSetInstallLevel définit le niveau d’installation d’une installation complète du produit.

Syntaxe

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

Paramètres

[in] hInstall

Gérez l’installation fournie à une action personnalisée DLL ou obtenue à l’aide de MsiOpenPackage, MsiOpenPackageEx ou MsiOpenProduct.

[in] iInstallLevel

Niveau d’installation.

Valeur retournée

La fonction MsiSetInstallLevel retourne l’une des valeurs suivantes :

Remarques

La fonction MsiSetInstallLevel définit les éléments suivants :

• Niveau d’installation de l’installation actuelle à une valeur spécifiée.
• Les états Sélectionner et Installé pour toutes les fonctionnalités de la table Fonctionnalité.
• État Action de chaque composant de la table Component, en fonction du nouveau niveau.

Pour toute installation, il existe un niveau d’installation défini, qui est une valeur intégrale comprise entre 1 et 32 767. La valeur initiale est déterminée par la propriété INSTALLLEVEL , qui est définie dans la table property.

Si 0 (zéro) ou un nombre négatif est passé dans le paramètre iInstallLevel , le niveau d’installation actuel ne change pas, mais toutes les fonctionnalités sont toujours mises à jour en fonction du niveau d’installation actuel. Pour plus d’informations, consultez Appel de fonctions de base de données à partir de programmes.

Si la fonction échoue, vous pouvez obtenir des informations d’erreur étendues à l’aide de MsiGetLastErrorRecord.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Installer 5.0 sur Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 sur Windows Server 2008 ou Windows Vista. Windows Installer sur Windows Server 2003 ou Windows XP
Plateforme cible	Windows
En-tête	msiquery.h
Bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

Fonctions de sélection du programme d’installation