À propos de l’invite de disque et de la gestion des erreurs

Bien que les fonctions d’installation ne fournissent pas d’interface utilisateur, il existe quatre fonctions d’installation qui génèrent des boîtes de dialogue pour gérer les situations d’installation courantes et collecter des informations auprès de l’utilisateur. Il s’agit de : SetupPromptForDisk, SetupCopyError, SetupRenameError et SetupDeleteError.

Les routines de rappel peuvent appeler ces fonctions pour créer des boîtes de dialogue pour faciliter le traitement des notifications envoyées par d’autres fonctions d’installation telles que SetupCommitFileQueue et SetupInstallFile.

La fonction SetupPromptForDisk invite l’utilisateur à insérer un média amovible, à spécifier un nouveau chemin d’accès source ou à annuler l’installation. L’application peut offrir des options supplémentaires à l’utilisateur, en fonction des indicateurs spécifiés lors de l’appel de la fonction. Il s’agit notamment d’ignorer le fichier actif ou de rechercher un nouveau chemin d’accès source.

Les trois fonctions , SetupCopyError, SetupRenameError et SetupDeleteError, créent des boîtes de dialogue qui interagissent avec l’utilisateur pour recueillir des informations auprès de l’utilisateur sur la procédure à suivre en cas d’erreur.

La fonction SetupCopyError génère une boîte de dialogue qui demande à l’utilisateur comment récupérer après une erreur de copie. L’utilisateur peut spécifier un nouveau chemin d’accès source pour l’opération de copie ou annuler l’installation. En fonction des indicateurs spécifiés lors de l’appel à SetupCopyError, l’utilisateur peut également être en mesure de rechercher un nouveau chemin d’accès source, d’afficher les détails de l’erreur ou d’ignorer le fichier actif.

Une boîte de dialogue qui demande à l’utilisateur comment traiter les erreurs qui se produisent pendant une opération de renommage de fichier peut être générée en appelant SetupRenameError. Avec cette boîte de dialogue, l’utilisateur a la possibilité de réessayer l’opération, d’ignorer l’opération de renommage en cours ou d’abandonner.

La fonction SetupDeleteError génère une boîte de dialogue qui peut collecter des entrées sur la façon dont l’utilisateur souhaite gérer une erreur qui s’est produite lors d’une opération de suppression de fichier. L’utilisateur dispose des options pour réessayer l’opération, ignorer l’opération de suppression en cours ou abandonner.

La routine de rappel de file d’attente par défaut, SetupDefaultQueueCallback, utilise les quatre fonctions mentionnées précédemment pour générer des parties de son interface utilisateur et pour gérer les erreurs et demander de nouveaux médias.