INSTALLUI_HANDLERW 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_HANDLERW InstalluiHandlerw;
int InstalluiHandlerw(
LPVOID pvContext,
UINT iMessageType,
LPCWSTR szMessage
)
{...}
Paramètres
pvContext
Pointeur vers un contexte d’application passé à la fonction msiSetExternalUI
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.
| Installer les types de messagesFlag | Signification |
|---|---|
|
Arrêt prématuré |
|
Message d’erreur mis en forme |
|
Message d’avertissement mis en forme |
|
Message de demande de l’utilisateur. |
|
Message informatif pour le journal |
|
Liste des fichiers actuellement utilisés qui doivent être fermés avant d’être remplacés. |
|
Demande pour déterminer un emplacement source valide |
|
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. |
|
Message d’espace disque insuffisant |
|
Début du message 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 de 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ée 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 de retour
Les valeurs de retour suivantes sont mappées aux boutons spécifiés par le style de zone 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 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 |