Partager via

INSTALLUI_HANDLERA fonction de rappel (msi.h)

  • Article

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.

Styles de boîte de messageGlag Signification
MB_ABORTRETRYIGNORE
 La zone de message contient les boutons Abandonner, Réessayer et Ignorer .
MB_OK
 La zone de message contient le bouton OK . Il s’agit de la valeur par défaut.
MB_OKCANCEL
 La zone de message contient les boutons OK et Annuler .
MB_RETRYCANCEL
 La zone de message contient les boutons Réessayer et Annuler .
MB_YESNO
 La zone de message contient les boutons Oui et Non .
MB_YESNOCANCEL
 La zone de message contient les boutons Oui, Non et Annuler .
 
Boîte de message IconTypesFlag Signification
MB_ICONEXCLAMATION, MB_ICONWARNING
 Un point d’exclamation s’affiche dans la zone de message.
MB_ICONINFORMATION, MB_ICONASTERISK
 Le signe d’informations s’affiche dans la boîte de message.
MB_ICONQUESTION
 Un point d’interrogation s’affiche dans la zone de message.
MB_ICONSTOP, MB_ICONERROR, MB_ICONHAND
 Un signe d’arrêt s’affiche dans la boîte de message.
 
Boutons par défautFlag 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 messageFlag 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 d’information pour le journal
INSTALLMESSAGE_FILESINUSE
 Liste des fichiers actuellement en cours d’utilisation qui doivent être fermés avant d’être remplacés.
INSTALLMESSAGE_RESOLVESOURCE
 Demande de détermination d’un emplacement source valide
INSTALLMESSAGE_RMFILESINUSE
 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.
INSTALLMESSAGE_OUTOFDISKSPACE
 Message d’espace disque insuffisant
INSTALLMESSAGE_ACTIONSTART
 Message de début 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 sur la 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é 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 retournée

Les valeurs de retour suivantes sont mappées aux boutons spécifiés par le style de boîte 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 .

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

Voir aussi

MsiSetExternalUI