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 è 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)