Informazioni sulla gestione delle richieste e degli errori sul disco
Anche se le funzioni di installazione non forniscono un'interfaccia utente, sono disponibili quattro funzioni di configurazione che generano finestre di dialogo per gestire situazioni di installazione comuni e raccogliere informazioni dall'utente. Questi sono: SetupPromptForDisk, SetupCopyError, SetupRenameError e 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 ignorare il file corrente o esplorare per un nuovo percorso di origine.
Le tre funzioni, SetupCopyError, SetupRenameError e SetupDeleteError, creano finestre di dialogo che interagiscono con l'utente per raccogliere informazioni dall'utente su come procedere quando si è verificato un errore.
La funzione SetupCopyError genera 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 degli errori 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 che può raccogliere input su come l'utente desidera gestire un errore che si è verificato durante un'operazione di eliminazione di file. L'utente ha le opzioni per riprovare 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 gestire gli errori e richiedere nuovi supporti.