Restituzione di valori da un gestore dell'interfaccia utente esterna
Un gestore dell'interfaccia utente esterno può restituire un numero qualsiasi di valori a Windows Installer a seconda del tipo di pulsante fornito nel parametro del tipo di messaggio passato dal programma di installazione al gestore.
Il gestore dell'interfaccia utente esterno può restituire i valori -1 e 0 in qualsiasi momento perché non sono correlati ai tipi di pulsante. Un valore restituito -1 indica che si è verificato un errore interno nel gestore dell'interfaccia utente esterno. Un valore restituito pari a 0 indica che il gestore dell'interfaccia utente esterno non ha gestito il messaggio del programma di installazione e il programma di installazione deve gestire 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 esterno.
I valori restituiti rimanenti, come descritto di seguito, sono direttamente correlati ai tipi di pulsante inclusi nel tipo di messaggio.
| Valore di ritorno dell'interfaccia utente esterna | Significato |
|---|---|
| IDOK | Il pulsante OK è stato premuto dall'utente. Le informazioni sul messaggio sono state comprese. |
| Annulla | È stato premuto il pulsante CANCEL. Annullare l'installazione. |
| IDABORT | È stato premuto il pulsante ABORT. Interrompere l'installazione. |
| IDRETRY | È stato premuto il pulsante RETRY. Riprova l'azione. |
| IDIGNORE | È stato premuto il pulsante IGNORA. Ignorare l'errore e continuare. |
| IDYES | È stato premuto il pulsante SÌ. La risposta è affermativa, proseguire con l'attuale sequenza di eventi. |
| IDNO | È stato premuto il pulsante NO. La risposta negativa, pertanto non continuare con la sequenza corrente di eventi. |
Ad esempio, se il gestore dell'interfaccia utente esterno riceve un messaggio con il flag degli stili della finestra di messaggio MB_ABORTRETRYIGNORE, il gestore UI esterno può restituire uno dei valori seguenti:
- –1 (errore nel gestore dell'interfaccia utente esterno)
- 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 (IGNORE pulsante premuto)