MsiSetInternalUI, fonction (msi.h)

La fonction MsiSetInternalUI active l’interface utilisateur interne du programme d’installation. Cette interface utilisateur est ensuite utilisée pour tous les appels suivants aux fonctions d’installation de génération d’interface utilisateur dans ce processus. Pour plus d’informations, consultez Niveaux d’interface utilisateur.

Syntaxe

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

Paramètres

[in] dwUILevel

Spécifie le niveau de complexité de l’interface utilisateur. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
INSTALLUILEVEL_FULL	Interface utilisateur créée avec des Assistants, la progression et les erreurs.
INSTALLUILEVEL_REDUCED	Interface utilisateur créée avec les boîtes de dialogue de l’Assistant supprimées.
INSTALLUILEVEL_BASIC	Gestion simple des progrès et des erreurs.
INSTALLUILEVEL_DEFAULT	Le programme d’installation choisit un niveau d’interface utilisateur approprié.
INSTALLUILEVEL_NONE	Installation entièrement sans assistance : Cela inclut la suppression de l’invite d’élévation même si nécessaire. Consultez INSTALLUILEVEL_UACONLY si vous souhaitez que l’utilisateur puisse s’élever.
INSTALLUILEVEL_ENDDIALOG	S’il est combiné avec l’une des valeurs ci-dessus, le programme d’installation affiche une boîte de dialogue modale à la fin d’une installation réussie ou en cas d’erreur. Aucune boîte de dialogue ne s’affiche si l’utilisateur annule l’opération.
INSTALLUILEVEL_PROGRESSONLY	S’il est combiné avec la valeur INSTALLUILEVEL_BASIC , le programme d’installation affiche des boîtes de dialogue de progression simples, mais n’affiche aucune boîte de dialogue modale ou boîte de dialogue d’erreur.
INSTALLUILEVEL_NOCHANGE	Aucune modification au niveau de l’interface utilisateur. Toutefois, si phWnd n’a pas la valeur Null, la fenêtre parente peut changer.
INSTALLUILEVEL_HIDECANCEL	S’il est combiné avec la valeur INSTALLUILEVEL_BASIC , le programme d’installation affiche des boîtes de dialogue de progression simples, mais n’affiche pas de bouton Annuler dans la boîte de dialogue. Cela empêche les utilisateurs d’annuler l’installation.
INSTALLUILEVEL_SOURCERESONLY	Si cette valeur est combinée avec la valeur INSTALLUILEVEL_NONE , le programme d’installation affiche uniquement les boîtes de dialogue utilisées pour la résolution de la source. Aucune autre boîte de dialogue n’est affichée. Cette valeur n’a aucun effet si le niveau d’interface utilisateur n’est pas INSTALLUILEVEL_NONE. Il est utilisé avec une interface utilisateur externe conçue pour gérer l’ensemble de l’interface utilisateur à l’exception de la résolution de la source. Dans ce cas, le programme d’installation gère la résolution de la source.
INSTALLUILEVEL_UACONLY	Si elle est combinée avec la valeur INSTALLUILEVEL_NONE , l’installation sera complètement silencieuse, à l’exception de l’invite d’élévation si nécessaire.

[in, out] phWnd

Pointeur vers une fenêtre. Cette fenêtre devient le propriétaire de toute interface utilisateur créée. Un pointeur vers le propriétaire précédent de l’interface utilisateur est retourné. Si ce paramètre a la valeur Null, le propriétaire de l’interface utilisateur ne change pas.

Valeur retournée

Le niveau d’interface utilisateur précédent est retourné. Si un dwUILevel non valide est passé, INSTALLUILEVEL_NOCHANGE est retourné.

Notes

La fonction MsiSetInternalUI est utile lorsque le programme d’installation doit afficher une interface utilisateur. Par exemple, si une fonctionnalité est installée, mais que la source est un disque compact qui doit être inséré, le programme d’installation invite l’utilisateur à entrer le disque compact. Selon la nature de l’installation, l’application peut également afficher des indicateurs de progression ou interroger l’utilisateur pour obtenir des informations.

Lorsque Msi.dll est chargé, le niveau d’interface utilisateur est défini sur DEFAULT et le propriétaire de l’interface utilisateur est défini sur 0 (autrement dit, le propriétaire initial de l’interface utilisateur est le bureau).

Configuration requise

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. Pour plus d’informations sur le Service Pack Windows requis par une version de Windows Installer, consultez Configuration requise pour le runtime Windows.
Plateforme cible	Windows
En-tête	msi.h
Bibliothèque	Msi.lib
DLL	Msi.dll

Voir aussi

Fonctions d’interface et de journalisation