Zurückgeben von Werten von einem externen Benutzeroberflächenhandler
Ein externer Benutzeroberflächenhandler kann je nach Schaltflächentyp, der im Nachrichtentypparameter angegeben ist, den das Installationsprogramm an den Handler übergibt, eine beliebige Anzahl von Werten an Windows Installer zurückgeben.
Der externe Benutzeroberflächenhandler kann die Werte „–1“ und 0 jederzeit zurückgeben, da sie nicht mit den Schaltflächentypen zusammenhängen. Der Rückgabewert „–1“ gibt an, dass im externen Benutzeroberflächenhandler ein interner Fehler aufgetreten ist. Der Rückgabewert „0“ gibt an, dass der externe Benutzeroberflächenhandler die Installationsprogrammmeldung nicht verarbeitet hat und dass stattdessen das Installationsprogramm die Nachricht verarbeiten muss.
Bei Nachrichten, die keinen Schaltflächentyp enthalten, z. B. INSTALLMESSAGE_ACTIONDATA und INSTALLMESSAGE_PROGRESS, wird die Installation abgebrochen, indem IDCANCEL zurückgegeben wird. Wenn IDOK zurückgegeben wird, wird das Installationsprogramm darüber benachrichtigt, dass die Nachricht vom externen Benutzeroberflächenhandler verarbeitet wurde.
Die verbleibenden Rückgabewerte, wie unten beschrieben, hängen direkt mit den Schaltflächentypen zusammen, die im Nachrichtentyp enthalten sind.
| Rückgabewert der externen Benutzeroberfläche | Bedeutung |
|---|---|
| IDOK | Der Benutzer hat auf die Schaltfläche OK geklickt. Die Nachrichteninformationen wurden verstanden. |
| IDCANCEL | Es wurde auf die Schaltfläche ABBRECHEN geklickt. Die Installation wird abgebrochen. |
| IDABORT | Die ABORT-Schaltfläche wurde gedrückt. Die Installation wird abgebrochen. |
| IDRETRY | Es wurde auf die Schaltfläche RETRY geklickt. Die Aktion wird wiederholt. |
| IDIGNORE | Es wurde auf die Schaltfläche IGNORE geklickt. Der Fehler wird ignoriert und der Vorgang wird fortgesetzt. |
| IDYES | Es wurde auf die Schaltfläche YES geklickt. Die positive Antwort bedeutet, dass die aktuelle Sequenz von Ereignissen fortgesetzt wird. |
| IDNO | Es wurde auf die Schaltfläche NO geklickt. Die negative Antwort bedeutet, dass die aktuelle Sequenz von Ereignissen nicht fortgesetzt wird. |
Wenn dem externen Benutzeroberflächenhandler beispielsweise eine Nachricht mit dem MB_ABORTRETRYIGNORE-Flag für Meldungsfeldstile gesendet wird, kann der externe Benutzeroberflächenhandler einen der folgenden Werte zurückgeben:
- –1 (Fehler im externen Benutzeroberflächenhandler)
- 0 (keine Aktion im externen Benutzeroberflächenhandler ausgeführt, von Windows Installer zu behandeln)
- IDABORT (ABORT-Schaltfläche gedrückt)
- IDRETRY (RETRY-Schaltfläche gedrückt)
- IDIGNORE (IGNORE-Schaltfläche gedrückt)