INSTALLUI_HANDLER_RECORD fonction de rappel (msi.h)

  • Article

Le prototype de fonction INSTALLUI_HANDLER_RECORD définit une fonction de rappel que le programme d’installation appelle pour les messages de notification de progression et d’erreur. Appelez la fonction MsiSetExternalUIRecord pour activer un gestionnaire d’interface utilisateur externe de base d’enregistrements.

Windows Installer 3.0 et Windows Installer 2.0 : Non pris en charge. Disponible à partir de Windows Installer version 3.1 et ultérieures.

Syntaxe

INSTALLUI_HANDLER_RECORD InstalluiHandlerRecord;

int InstalluiHandlerRecord(
  LPVOID pvContext,
  UINT iMessageType,
  MSIHANDLE hRecord
)
{...}

Paramètres

pvContext

Pointeur vers un contexte d’application passé à la fonction MsiSetExternalUIRecord . 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 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.

Styles de boîte de messageFlag Signification
MB_ABORTRETRYIGNORE
 La boîte de message contient les boutons Abandonner, Réessayer et Ignorer .
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, Non et Annuler .
 
Boîte de message IconTypesFlag Signification
MB_ICONEXCLAMATION, MB_ICONWARNING
 Un point d’exclamation s’affiche dans la boîte 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 utilisés 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 utilisés qui doivent être fermés avant d’être remplacés. Disponible à partir de Windows Installer version 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 de jauge de progression. Ce message contient 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é.

hRecord

Spécifie un handle pour l’objet d’enregistrement. Pour plus d’informations sur les objets d’enregistrement, consultez fonctions de traitement des enregistrements.

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

Ce type de gestionnaire d’interface utilisateur externe doit être utilisé lorsqu’il est connu du type d’erreurs ou de messages qui intéresse l’appelant et qu’il souhaite éviter la surcharge liée à l’analyse du message de chaîne envoyé à un gestionnaire d’interface utilisateur externe de INSTALLUI_HANDLER type, mais qu’il récupère les données intéressantes à partir des champs de hRecord.

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 . L’objet hRecord envoyé au gestionnaire d’interface utilisateur externe basé sur un enregistrement appartient à Windows Installer et est valide uniquement pour la durée de vie du rappel. Le rappel doit extraire de l’enregistrement toutes les données dont il a besoin et il ne doit pas fermer ce handle.

Toute tentative d’un gestionnaire d’interface utilisateur externe basé sur un enregistrement de modifier les données de l’objet hRecord sera ignorée par Windows Installer.

Pour plus d’informations sur l’utilisation d’un gestionnaire externe basé sur les enregistrements, consultez Surveillance d’une installation à l’aide de MsiSetExternalUIRecord.

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 3.1 sur Windows Server 2003 ou Windows XP.
Plateforme cible Windows
En-tête msi.h

Voir aussi

MsiSetExternalUI

Non pris en charge dans Windows Installer 3.0 et versions antérieures