INSTALLUI_HANDLERA fonction de rappel (msi.h)
Le prototype de fonction INSTALLUI_HANDLER définit une fonction de rappel que le programme d’installation appelle pour la notification de progression et les messages d’erreur. Pour plus d’informations sur l’utilisation de ce prototype de fonction, un exemple d’extrait de code est disponible dans Gestion des messages de progression à l’aide de MsiSetExternalUI.
Syntaxe
INSTALLUI_HANDLERA InstalluiHandlera;
int InstalluiHandlera(
LPVOID pvContext,
UINT iMessageType,
LPCSTR szMessage
)
{...}
Paramètres
pvContext
Pointeur vers un contexte d’application passé à la fonction MsiSetExternalUI . Ce paramètre peut être utilisé pour la vérification des erreurs.
iMessageType
Spécifie une combinaison d’un style de boîte de message, d’un type d’icône de zone de message, d’un bouton par défaut et d’un type de message d’installation. Ce paramètre doit être l’un des suivants.
| Installer les types de messageFlag | Signification |
|---|---|
|
Arrêt prématuré |
|
Message d’erreur mis en forme |
|
Message d’avertissement mis en forme |
|
Message de demande de l’utilisateur. |
|
Message d’information pour le journal |
|
Liste des fichiers actuellement en cours d’utilisation qui doivent être fermés avant d’être remplacés. |
|
Demande de détermination d’un emplacement source valide |
|
Liste des fichiers actuellement en cours d’utilisation qui doivent être fermés avant d’être remplacés. Disponible à partir de Windows Installer 4.0. Pour plus d’informations, consultez Utilisation du Gestionnaire de redémarrage avec une interface utilisateur externe. |
|
Message d’espace disque insuffisant |
|
Message de début d’action. Ce message inclut le nom et la description de l’action. |
|
Données mises en forme associées à l’élément d’action individuel. |
|
Informations sur la jauge de progression. Ce message inclut des informations sur les unités jusqu’à présent et le nombre total d’unités. |
|
Informations de boîte de dialogue mises en forme pour l’interface utilisateur. |
|
Envoyé avant l’initialisation de l’interface utilisateur, aucune donnée de chaîne |
|
Envoyé après l’arrêt de l’interface utilisateur, aucune donnée de chaîne |
|
Envoyé avant l’affichage de la boîte de dialogue ou de l’Assistant créé |
|
Envoyé avant l’installation du produit. |
|
Envoyé après l’installation du produit. |
Les valeurs par défaut suivantes doivent être utilisées si l’un des messages précédents est manquant : MB_OK, aucune icône et MB_DEFBUTTON1. Il n’existe aucun type de message d’installation par défaut ; un type de message est toujours spécifié.
szMessage
Spécifie le texte du message.
Valeur retournée
Les valeurs de retour suivantes sont mappées aux boutons spécifiés par le style de boîte de message :
IDOK
Remarques
Pour plus d’informations sur le retour de valeurs à partir d’un gestionnaire d’interface utilisateur externe, consultez la rubrique Retour de valeurs à partir d’un gestionnaire d’interface utilisateur externe .
Notes
L’en-tête msi.h définit INSTALLUI_HANDLER en tant qu’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. La combinaison 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.
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 | msi.h |