Informazioni sulla richiesta del disco e sulla gestione degli errori
Anche se le funzioni di installazione non forniscono un'interfaccia utente, esistono quattro funzioni di installazione che generano finestre di dialogo per gestire situazioni di installazione comuni e raccogliere informazioni dall'utente. Questi sono: SetupPromptForDisk, SetupCopyError, SetupRenameErrore SetupDeleteError.
Le routine di callback possono chiamare queste funzioni per creare finestre di dialogo per facilitare l'elaborazione delle notifiche inviate da altre funzioni di installazione, ad esempio SetupCommitFileQueue e SetupInstallFile.
La funzione SetupPromptForDisk richiede all'utente di inserire supporti rimovibili, specificare un nuovo percorso di origine o annullare l'installazione. L'applicazione può offrire opzioni aggiuntive all'utente, a seconda dei flag specificati quando viene chiamata la funzione. Questi includono l'omissione del file corrente o l'esplorazione di un nuovo percorso di origine.
Le tre funzioni, SetupCopyError, SetupRenameErrore SetupDeleteError, creare finestre di dialogo che interagiscono con l'utente per raccogliere informazioni dall'utente su come procedere quando si è verificato un errore.
La funzionesetupCopyErrorgenera una finestra di dialogo che chiede all'utente come eseguire il ripristino da un errore di copia. L'utente può specificare un nuovo percorso di origine per l'operazione di copia o annullare l'installazione. A seconda dei flag specificati durante la chiamata a SetupCopyError, l'utente può anche essere in grado di cercare un nuovo percorso di origine, visualizzare i dettagli dell'errore o ignorare il file corrente.
Una finestra di dialogo che chiede all'utente come elaborare gli errori che si verificano durante un'operazione di ridenominazione di file può essere generata chiamando SetupRenameError. Con questa finestra di dialogo, l'utente ha la possibilità di ripetere l'operazione, ignorare l'operazione di ridenominazione corrente o interrompere l'operazione.
La funzione SetupDeleteError genera una finestra di dialogo in grado di raccogliere input su come l'utente desidera gestire un errore che si è verificato durante un'operazione di eliminazione di file. All'utente vengono assegnate le opzioni per ritentare l'operazione, ignorare l'operazione di eliminazione corrente o interrompere l'operazione.
La routine di callback della coda predefinita, SetupDefaultQueueCallback, usa le quattro funzioni indicate in precedenza per generare parti dell'interfaccia utente e per gestire gli errori e richiedere nuovi supporti (media).