Over schijfprompt en foutafhandeling

Hoewel de installatiefuncties geen gebruikersinterface bieden, zijn er vier installatiefuncties waarmee dialoogvensters worden gegenereerd voor het afhandelen van veelvoorkomende installatiesituaties en het verzamelen van informatie van de gebruiker. Dit zijn: SetupPromptForDisk, SetupCopyError, SetupRenameErroren SetupDeleteError.

Callback-routines kunnen deze functies aanroepen om dialoogvensters te maken om te helpen bij het verwerken van meldingen die worden verzonden door andere installatiefuncties, zoals SetupCommitFileQueue en SetupInstallFile.

De functie SetupPromptForDisk vraagt de gebruiker om verwisselbare media in te voegen, een nieuw bronpad op te geven of de installatie te annuleren. De toepassing kan extra opties bieden aan de gebruiker, afhankelijk van de vlaggen die zijn opgegeven wanneer de functie wordt aangeroepen. Dit omvat het overslaan van het huidige bestand of het bladeren naar een nieuw bronpad.

De drie functies, SetupCopyError, SetupRenameErroren SetupDeleteError, dialoogvensters maken die communiceren met de gebruiker om informatie van de gebruiker te verzamelen over hoe u doorgaat wanneer er een fout is opgetreden.

Met de functie SetupCopyError wordt een dialoogvenster gegenereerd waarin de gebruiker wordt gevraagd om een kopieerfout te herstellen. De gebruiker kan een nieuw bronpad opgeven voor de kopieerbewerking of de installatie annuleren. Afhankelijk van de vlaggen die zijn opgegeven tijdens de aanroep naar SetupCopyError, kan de gebruiker mogelijk ook bladeren naar een nieuw bronpad, foutdetails bekijken of het huidige bestand overslaan.

Een dialoogvenster waarin de gebruiker wordt gevraagd fouten te verwerken die optreden tijdens een bewerking voor het wijzigen van de naam van een bestand, kan worden gegenereerd door SetupRenameError-aan te roepen. Met dit dialoogvenster heeft de gebruiker de mogelijkheid om de bewerking opnieuw uit te voeren, de huidige naamswijzigingsbewerking over te slaan of af te breken.

Met de functie SetupDeleteError wordt een dialoogvenster gegenereerd dat invoer kan verzamelen over de manier waarop de gebruiker een fout wil verwerken die is opgetreden tijdens het verwijderen van een bestand. De gebruiker krijgt de opties om de bewerking opnieuw uit te voeren, de huidige verwijderbewerking over te slaan of af te breken.

De standaardoproeproutine voor wachtrijen, SetupDefaultQueueCallback, gebruikt de eerder genoemde vier functies om onderdelen van de gebruikersinterface te genereren en fouten af te handelen en om nieuwe media te vragen.