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 les messages d’erreur et de notification de progression. 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 zone de message, d’un type d’icône de boîte de message, d’un bouton par défaut et d’un type de message d’installation. Ce paramètre doit être l’un des éléments suivants.

StylesFlag de boîte de message Signification
MB_ABORTRETRYIGNORE
La boîte de message contient les boutons Abandonner, réessayeret Ignorer les boutons.
MB_OK
La boîte de message contient le bouton OK. Il s’agit de la valeur par défaut.
MB_OKCANCEL
La boîte de message contient les boutons OK et Annuler.
MB_RETRYCANCEL
La boîte de message contient les boutons Réessayer et Annuler.
MB_YESNO
La boîte de message contient les boutons Oui et Non.
MB_YESNOCANCEL
La boîte de message contient les boutons Oui, Nonet Annuler.
 
Boîte de message IconTypesFlag Signification
MB_ICONEXCLAMATION, MB_ICONWARNING
Un point d’exclamation apparaît dans la boîte de message.
MB_ICONINFORMATION, MB_ICONASTERISK
La connexion d’informations s’affiche dans la boîte de message.
MB_ICONQUESTION
Un point d’interrogation apparaît dans la boîte de message.
MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND
Un signe d’arrêt s’affiche dans la boîte de message.
 
ButtonsFlag par défaut Signification
MB_DEFBUTTON1
Le premier bouton est le bouton par défaut.
MB_DEFBUTTON2
Le deuxième bouton est le bouton par défaut.
MB_DEFBUTTON3
Le troisième bouton est le bouton par défaut.
 
Installer les types de messagesFlag Signification
INSTALLMESSAGE_FATALEXIT
Arrêt prématuré
INSTALLMESSAGE_ERROR
Message d’erreur mis en forme
INSTALLMESSAGE_WARNING
Message d’avertissement mis en forme
INSTALLMESSAGE_USER
Message de demande de l’utilisateur.
INSTALLMESSAGE_INFO
Message informatif pour le journal
INSTALLMESSAGE_FILESINUSE
Liste des fichiers actuellement utilisés qui doivent être fermés avant d’être remplacés.
INSTALLMESSAGE_RESOLVESOURCE
Demande pour déterminer un emplacement source valide
INSTALLMESSAGE_RMFILESINUSE
Liste des fichiers actuellement utilisés qui doivent être fermés avant d’être remplacés. Disponible à partir de Windows Installer 4.0. Pour plus d’informations sur ce message, consultez Utilisation du Gestionnaire de redémarrage avec une interface utilisateur externe.
INSTALLMESSAGE_OUTOFDISKSPACE
Message d’espace disque insuffisant
INSTALLMESSAGE_ACTIONSTART
Début du message d’action. Ce message inclut le nom et la description de l’action.
INSTALLMESSAGE_ACTIONDATA
Données mises en forme associées à l’élément d’action individuel.
INSTALLMESSAGE_PROGRESS
Informations de jauge de progression. Ce message inclut des informations sur les unités jusqu’à présent et le nombre total d’unités.
INSTALLMESSAGE_COMMONDATA
Informations de boîte de dialogue mises en forme pour l’interface utilisateur.
INSTALLMESSAGE_INITIALIZE
Envoyée avant l’initialisation de l’interface utilisateur, aucune donnée de chaîne
INSTALLMESSAGE_TERMINATE
Envoyé après l’arrêt de l’interface utilisateur, aucune donnée de chaîne
INSTALLMESSAGE_SHOWDIALOG
Envoyé avant l’affichage de la boîte de dialogue ou de l’Assistant créé
INSTALLMESSAGE_INSTALLSTART
Envoyé avant l’installation du produit.
INSTALLMESSAGE_INSTALLEND
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 de retour

Les valeurs de retour suivantes sont mappées aux boutons spécifiés par le style de zone de message :

IDOK

 
IDCANCEL
 
IDABORT
 
IDRETRY
 
IDIGNORE
 
IDYES
 
IDNO

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 rubrique.

Note

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. 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
plateforme cible Windows
d’en-tête msi.h

Voir aussi

msiSetExternalUI