Informationen zur Datenträgeraufforderung und Fehlerbehandlung
Obwohl die Setupfunktionen keine Benutzeroberfläche bereitstellen, gibt es vier Setupfunktionen, die Dialogfelder generieren, um häufige Installationssituationen zu behandeln und Informationen vom Benutzer zu sammeln. Dies sind: SetupPromptForDisk, SetupCopyError, SetupRenameErrorund SetupDeleteError.
Rückrufroutinen können diese Funktionen aufrufen, um Dialogfelder zu erstellen, die bei der Verarbeitung von Benachrichtigungen helfen, die von anderen Setupfunktionen wie SetupCommitFileQueue und SetupInstallFile gesendet werden.
Die SetupPromptForDisk-Funktion fordert den Benutzer auf, Wechselmedien einlegen, einen neuen Quellpfad anzugeben oder die Installation abzubricht. Die Anwendung kann dem Benutzer zusätzliche Optionen anbieten, abhängig von den Flags, die beim Aufgerufenen der Funktion angegeben werden. Dazu gehört das Überspringen der aktuellen Datei oder das Suchen nach einem neuen Quellpfad.
Die drei Funktionen SetupCopyError, SetupRenameErrorund SetupDeleteErrorerstellen Dialogfelder, die mit dem Benutzer interagieren, um Informationen vom Benutzer zum Fortfahren zu sammeln, wenn ein Fehler aufgetreten ist.
Die Funktion SetupCopyError generiert ein Dialogfeld, in dem der Benutzer gefragt wird, wie er nach einem Kopierfehler wiederhergestellt werden soll. Der Benutzer kann einen neuen Quellpfad für den Kopiervorgang angeben oder die Installation abbrechen. Abhängig von den Flags, die während des Aufrufs von SetupCopyError angegeben wurden, kann der Benutzer möglicherweise auch nach einem neuen Quellpfad suchen, Fehlerdetails anzeigen oder die aktuelle Datei überspringen.
Ein Dialogfeld, in dem der Benutzer aufgefordert wird, Fehler zu verarbeiten, die während eines Datei-Umbenennungsvorgangs auftreten, kann durch Aufrufen von SetupRenameError generiert werden. Mit diesem Dialogfeld kann der Benutzer den Vorgang wiederholen, den aktuellen Umbenennungsvorgang überspringen oder abbrechen.
Die SetupDeleteError-Funktion generiert ein Dialogfeld, das eingaben kann, wie der Benutzer einen Fehler behandeln möchte, der während eines Dateilöschungsvorgang aufgetreten ist. Der Benutzer hat die Möglichkeit, den Vorgang erneut zu versuchen, den aktuellen Löschvorgang zu überspringen oder den Vorgang zu abbrechen.
Die Standardroutine für den Warteschlangenrückruf SetupDefaultQueueCallbackverwendet die zuvor genannten vier Funktionen, um Teile der Benutzeroberfläche zu generieren und Fehler zu behandeln und neue Medien anfordern.