Ordre d’engagement de file d’attente

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 schéma suivant illustre le cycle de vie du processus d’engagement d’une file d’attente.

 

• démarrer la sous-file d’attente de suppression
  • démarrer une opération <de suppression de fichier - répéter pour chaque
  • terminer une opération <de suppression de fichier -- suppression de fichier en file d’attente
• terminer la sous-file d’attente de suppression

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

• démarrer la sous-file d’attente de copie
  • démarrer une opération <de copie de fichiers - répéter pour chaque
  • terminer une opération <de copie de fichiers - copie de fichiers mise en file d’attente
  • terminer la 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 au niveau du chemin actuel, SetupCommitFileQueue envoie une notification SPFILENOTIFY_NEEDMEDIA à la routine de rappel, ainsi que des informations sur le fichier et le média 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 telle quelle, ou écrire une routine de rappel de filtre pour gérer un sous-ensemble des notifications et passer les autres à la routine de rappel de file d’attente par défaut.

Si aucune des fonctionnalités de la routine de rappel ne répond à 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éfaut et Création d’une routine de rappel de file d’attente personnalisée.