Retour de valeurs à partir d’un gestionnaire d’interface utilisateur externe

Un gestionnaire d’interface utilisateur externe peut retourner n’importe quel nombre de valeurs à Windows Installer en fonction du type de bouton fourni dans le paramètre de type de message que le programme d’installation transmet au gestionnaire.

Le gestionnaire d’interface utilisateur externe peut retourner les valeurs 1 et 0 à tout moment, car celles-ci ne sont pas liées aux types de boutons. Une valeur de retour de –1 indique qu’une erreur interne s’est produite dans le gestionnaire d’interface utilisateur externe. La valeur de retour 0 indique que le gestionnaire d’interface utilisateur externe n’a pas géré le message du programme d’installation et que le programme d’installation doit le gérer à la place.

Pour les messages qui n’incluent pas de type de bouton, comme INSTALLMESSAGE_ACTIONDATA et INSTALLMESSAGE_PROGRESS, le renvoi d’IDCANCEL annule l’installation. Le renvoi d’IDOK avertit le programme d’installation que le message a été géré par le gestionnaire d’interface utilisateur externe.

Les valeurs de retour restantes, comme décrit ci-dessous, sont directement liées aux types de boutons inclus avec le type de message.

Valeur de retour de l’interface utilisateur externe Signification
IDOK L’utilisateur a appuyé sur le bouton OK. Les informations du message ont été comprises.
IDCANCEL Le bouton CANCEL a été utilisé. Annuler l’installation.
IDABORT Le bouton ABORT a été utilisé. Abandonner l’installation.
IDRETRY Le bouton RETRY a été utilisé. Réessayer l’action.
IDIGNORE Le bouton IGNORE a été utilisé. Ignorer l’erreur et continuer.
IDYES Le bouton YES a été utilisé. La réponse affirmative ; poursuite de la séquence actuelle d’événements.
IDNO Le bouton NO a été utilisé. La réponse négative ; ne continue pas la séquence d’événements actuelle.

 

Par exemple, si le gestionnaire d’interface utilisateur externe reçoit un message avec l’indicateur de styles de boîte de message MB_ABORTRETRYIGNORE, le gestionnaire d’interface utilisateur externe peut retourner l’une des valeurs suivantes :

  • –1 (erreur dans le gestionnaire d’interface utilisateur externe)
  • 0 (aucune action effectuée dans le gestionnaire d’interface utilisateur externe, laisser Windows Installer gérer cela)
  • IDABORT (bouton ABORT utilisé)
  • IDRETRY (bouton RETRY utilisé)
  • IDIGNORE (bouton IGNORE utilisé)