Zwracanie wartości z zewnętrznego programu obsługi interfejsu użytkownika
Zewnętrzna procedura obsługi interfejsu użytkownika może zwrócić dowolną liczbę wartości do Instalatora Windows w zależności od typu przycisku określonego w parametrze typu komunikatu, który instalator przekazuje do programu obsługi.
Zewnętrzna procedura obsługi interfejsu użytkownika może w dowolnym momencie zwracać wartości –1 i 0, ponieważ nie są one powiązane z typami przycisków. Wartość zwracana –1 wskazuje, że w zewnętrznej procedurze obsługi interfejsu użytkownika wystąpił błąd wewnętrzny. Wartość zwracana 0 wskazuje, że zewnętrzny handler interfejsu użytkownika nie obsłużył komunikatu instalatora, a instalator musi zamiast tego obsłużyć komunikat.
W przypadku komunikatów, które nie zawierają typu przycisku, takiego jak INSTALLMESSAGE_ACTIONDATA i INSTALLMESSAGE_PROGRESS, zwrócenie IDCANCEL anuluje instalację. Zwracany kod IDOK powiadamia instalatora, że komunikat został obsłużony przez zewnętrzną procedurę obsługi interfejsu użytkownika.
Pozostałe wartości zwracane, jak opisano poniżej, są bezpośrednio związane z typami przycisków dołączonymi do typu komunikatu.
| Wartość zwracana przez zewnętrzny interfejs użytkownika | Znaczenie |
|---|---|
| IDOK | Użytkownik nacisnął przycisk OK. Treść wiadomości została zrozumiana. |
| IDCANCEL | Przycisk ANULUJ został naciśnięty. Anuluj instalację. |
| IDABORT | Przycisk ABORT został naciśnięty. Przerwanie instalacji. |
| IDRETRY | Przycisk PONów Próbę został naciśnięty. Spróbuj jeszcze raz. |
| IDIGNORE | Przycisk IGNORUJ został naciśnięty. Ignoruj błąd i kontynuuj. |
| IDYES | Przycisk TAK został naciśnięty. Odpowiedź twierdząca, kontynuuj bieżącą sekwencję zdarzeń. |
| IDNO | Przycisk NIE został naciśnięty. Negatywna odpowiedź, nie kontynuuj bieżącej sekwencji zdarzeń. |
Na przykład, jeśli do zewnętrznego modułu obsługi interfejsu użytkownika zostanie wysłana wiadomość z flagą stylów okna dialogowego MB_ABORTRETRYIGNORE, zewnętrzny moduł obsługi interfejsu użytkownika może zwrócić jedną z następujących wartości:
- –1 (błąd w zewnętrznej procedurze obsługi interfejsu użytkownika)
- 0 (brak akcji podjętej w zewnętrznej procedurze obsługi interfejsu użytkownika, niech Instalator Windows go obsłuży)
- IDABORT (przycisk ABORT naciśnięty)
- IDRETRY (przycisk PONÓW naciśnięty)
- IDIGNORE (ignoruj naciśnięcie przycisku)