Partager via

Ordre de l’engagement de file d’attente

  • Article

Lorsque la fonction SetupCommitFileQueue valide la file d’attente de fichiers, elle traite les opérations de fichier dans l’ordre suivant : opérations de suppression de fichier, opérations de changement de nom de fichier, et enfin, opérations de copie de fichiers. Le plan suivant illustre le cycle de vie du processus d’engagement d’une file d’attente.

 

  • démarrer le sous-file d’attente de suppression
    • démarrer une opération de suppression de fichier <- répétez pour chaque opération
    • terminer une opération de suppression de fichier <-- suppression de fichier en file d’attente
  • terminer le sous-file d’attente de suppression
  • démarrer le sous-file d’attente renommer
    • démarrer une opération de renommage de fichier <- répétez pour chaque opération
    • terminer une opération de suppression de fichier <-- nom de fichier mis en file d’attente
  • terminer le sous-file d’attente renommer
  • démarrer la sous-file d’attente de copie
    • démarrer une opération de copie de fichier <- répétez pour chaque opération
    • terminer une opération de copie de fichier <-- copie de fichier mise en file d’attente
    • terminer le sous-file d’attente de copie
  • terminer la file d’attente

 

À chaque étape ou si une erreur se produit, la fonction SetupCommitFileQueue envoie une notification à la routine de rappel. La routine de rappel peut utiliser les informations envoyées par la file d’attente pour suivre la progression de l’installation et, si nécessaire, interagir avec l’utilisateur.

Par exemple, si une opération de copie de fichiers nécessitait un fichier source qui n’était pas disponible sur le chemin d’accès actuel, SetupCommitFileQueue envoyait une notification SPFILENOTIFY_NEEDMEDIA à la routine de rappel, ainsi que des informations sur le fichier et le support requis. La routine de rappel peut utiliser ces informations pour générer une boîte de dialogue qui invite l’utilisateur à insérer le disque suivant en appelant SetupPromptForDisk

Une routine de rappel de file d’attente par défaut, SetupDefaultQueueCallback, est incluse avec l’API d’installation. Cette routine gère les notifications de file d’attente et génère des boîtes de dialogue d’erreur et des barres de progression pour l’installation. Vous pouvez utiliser la routine de rappel de file d’attente par défaut, ou écrire une routine de rappel de filtre pour gérer un sous-ensemble des notifications et transmettre les autres à la routine de rappel de file d’attente par défaut.

Si aucune des fonctionnalités de la routine de rappel ne correspond à vos besoins, vous pouvez écrire une routine de rappel personnalisée autonome qui n’appelle pas la routine de rappel de file d’attente par défaut.

Pour plus d’informations sur les routines de rappel de file d’attente, consultez routine de rappel de file d’attente par défautet Création d’une routine de rappel de file d’attente personnalisée.