MsiSetExternalUIA, fonction (msi.h)
La fonction MsiSetExternalUI active un gestionnaire d’interface utilisateur externe. Ce gestionnaire d’interface utilisateur externe est appelé avant le gestionnaire d’interface utilisateur interne normal. Le gestionnaire d’interface utilisateur externe a la possibilité de supprimer l’interface utilisateur interne en retournant une valeur différente de zéro pour indiquer qu’elle a géré les messages. Pour plus d’informations, consultez À propos de l’interface utilisateur.
Syntaxe
INSTALLUI_HANDLERA MsiSetExternalUIA(
[in] INSTALLUI_HANDLERA puiHandler,
[in] DWORD dwMessageFilter,
[in] LPVOID pvContext
);
Paramètres
[in] puiHandler
Spécifie une fonction de rappel conforme à la spécification INSTALLUI_HANDLER.
[in] dwMessageFilter
Spécifie les messages à gérer à l’aide du gestionnaire de messages externes. Si le gestionnaire externe retourne un résultat non nul, ce message ne sera pas envoyé à l’interface utilisateur, au lieu de cela, le message sera journalisé si la journalisation a été activée. Pour plus d’informations, consultez la fonction MsiEnableLog.
| Valeur | Signification |
|---|---|
|
Fichiers en cours d’utilisation. Lorsque ce message est reçu, une boîte de dialogue FilesInUse doit s’afficher. |
|
Arrêt prématuré de l’installation. |
|
Les messages d’erreur sont enregistrés. |
|
Les messages d’avertissement sont enregistrés. |
|
Les demandes utilisateur sont journalisées. |
|
Les messages d’état qui ne sont pas affichés sont enregistrés. |
|
Demande de déterminer un emplacement source valide. |
|
Fichiers en cours d’utilisation. Lorsque ce message est reçu, une boîte de dialogue MsiRMFilesInUse doit être affichée. |
|
L’espace disque était insuffisant. |
|
Le début des nouvelles actions d’installation est journalisé. |
|
L’enregistrement de données avec l’action d’installation est journalisé. |
|
Les paramètres d’initialisation de l’interface utilisateur sont enregistrés. |
|
barre de progression informations. Ce message inclut des informations sur les unités jusqu’à présent et le nombre total d’unités. Pour obtenir une explication du format de message, consultez la fonction MsiProcessMessage. Ce message est envoyé uniquement à une interface utilisateur externe et n’est pas journalisé. |
|
S’il ne s’agit pas d’une installation silencieuse, l’interface utilisateur de base a été initialisée. S’il s’agit d’une installation complète de l’interface utilisateur, la complète de l’interface utilisateur n’est pas encore initialisée. Ce message est envoyé uniquement à une interface utilisateur externe et n’est pas journalisé. |
|
Si une d’interface utilisateur complète est utilisée, l' d’interface utilisateur complète s’est terminée. S’il ne s’agit pas d’une installation silencieuse, l’interface utilisateur de base n’a pas encore pris fin. Ce message est envoyé uniquement à une interface utilisateur externe et n’est pas journalisé. |
|
Envoyé avant l’affichage de la boîte de dialogue interface utilisateur complète. Ce message est envoyé uniquement à une interface utilisateur externe et n’est pas journalisé. |
|
L’installation du produit commence.
Le message contient ProductName et ProductCode du produit. |
|
L’installation du produit se termine.
Le message contient la valeur ProductName, ProductCode et return du produit. |
[in] pvContext
Pointeur vers un contexte d’application passé à la fonction de rappel. Ce paramètre peut être utilisé pour la vérification des erreurs.
Valeur de retour
La valeur de retour est le gestionnaire externe défini précédemment, ou zéro (0) s’il n’y avait pas de gestionnaire défini précédemment.
Remarques
Pour restaurer le gestionnaire d’interface utilisateur précédent, le deuxième appel est effectué pour MsiSetExternalUI à l’aide du INSTALLUI_HANDLER retourné par le premier appel à MsiSetExternalUI et en spécifiant zéro (0) pour dwMessageFilter.
Le gestionnaire d’interface utilisateur externe pointé par le paramètre puiHandler
msiSetExternalUI ne doit être appelé qu’à partir d’une application bootstrapping. Vous ne pouvez pas appeler msiSetExternalUI à partir d’une action personnalisée.
Note
L’en-tête msi.h définit MsiSetExternalUI comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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. Consultez la configuration requise de Windows Installer Run-Time pour plus d’informations sur le service pack Windows minimal requis par une version de Windows Installer. |
| plateforme cible | Windows |
| d’en-tête | msi.h |
| bibliothèque | Msi.lib |
| DLL | Msi.dll |