Restituzione di valori da un gestore dell'interfaccia utente esterna
Un gestore dell'interfaccia utente esterna può restituire qualsiasi numero di valori a Windows Installer a seconda del tipo di pulsante fornito nel parametro del tipo di messaggio che il programma di installazione passa al gestore.
Il gestore dell'interfaccia utente esterna può restituire i valori -1 e 0 in qualsiasi momento perché non sono correlati ai tipi di pulsante. Un valore restituito di -1 indica che si è verificato un errore interno nel gestore dell'interfaccia utente esterna. Un valore restituito 0 indica che il gestore dell'interfaccia utente esterna non ha gestito il messaggio del programma di installazione e il programma di installazione deve gestire invece il messaggio.
Per i messaggi che non includono un tipo di pulsante, ad esempio INSTALLMESSAGE_ACTIONDATA e INSTALLMESSAGE_PROGRESS, la restituzione di IDCANCEL annulla l'installazione. La restituzione di IDOK notifica al programma di installazione che il messaggio è stato gestito dal gestore dell'interfaccia utente esterna.
I valori restituiti rimanenti, come descritto di seguito, sono direttamente correlati ai tipi di pulsante inclusi nel tipo di messaggio.
| Valore restituito dall'interfaccia utente esterna | Significato |
|---|---|
| IDOK | Il pulsante OK è stato premuto dall'utente. Le informazioni sul messaggio sono state comprese. |
| IDCANCEL | Il pulsante CANCEL è stato premuto. Annullare l'installazione. |
| IDABORT | Il pulsante ABORT è stato premuto. Interrompere l'installazione. |
| IDRETRY | Il pulsante RETRY è stato premuto. Riprovare l'azione. |
| IDIGNORE | Il pulsante IGNORE è stato premuto. Ignorare l'errore e continuare. |
| IDYES | Il pulsante SÌ è stato premuto. Risposta affermativa, continuare con la sequenza corrente di eventi.. |
| IDNO | Il pulsante NO è stato premuto. La risposta negativa non continua con la sequenza corrente di eventi. |
Ad esempio, se il gestore dell'interfaccia utente esterno viene inviato un messaggio con il flag di stili della finestra di messaggio MB_ABORTRETRYIGNORE, il gestore dell'interfaccia utente esterna può restituire uno dei valori seguenti:
- –1 (errore nel gestore dell'interfaccia utente esterna)
- 0 (nessuna azione eseguita nel gestore dell'interfaccia utente esterna, consentire a Windows Installer di gestirla)
- IDABORT (pulsante ABORT premuto)
- IDRETRY (pulsante RETRY premuto)
- IDIGNORE (pulsante IGNORE premuto)