À propos de la routine de rappel de file d’attente par défaut

La routine de rappel de file d’attente par défaut gère les notifications envoyées par SetupCommitFileQueue de manière générique. En utilisant la routine par défaut, vous obtenez une interface utilisateur prête à l’emploi pour créer des boîtes de dialogue d’installation courantes. Il est recommandé d’utiliser la routine de rappel de file d’attente par défaut, à la fois pour faciliter l’utilisation et pour garantir une apparence et un comportement cohérents des boîtes de dialogue générées pendant l’installation.

La routine de rappel par défaut nécessite une structure de contexte pour la conservation des enregistrements internes. En outre, la file d’attente transmet des informations supplémentaires pertinentes pour la notification actuelle dans un ensemble de paramètres, Param1 et Param2.

Par exemple, si la file d'attente envoie une notification SPFILENOTIFY_NEEDMEDIA à la routine de rappel par défaut, Param1 pointe vers une structure SOURCE_MEDIA qui contient des informations sur le support nécessaire, et Param2 pointe vers un tableau de caractères capable de recevoir de nouvelles informations sur le chemin d’accès fournies par l’utilisateur.

La routine de rappel par défaut utilise ces informations pour inviter l’utilisateur à insérer le média source nécessaire, spécifier un nouveau chemin, ignorer la copie du fichier actif ou annuler l’opération actuelle. La routine de rappel de file d’attente par défaut retourne FILEOP_NEWPATH, FILEOP_DOIT , FILEOP_SKIP ou FILEOP_ABORT à la file d’attente, selon l’action effectuée par l’utilisateur.

Pour plus d’informations sur la façon dont la routine de rappel de file d’attente par défaut gère chaque notification de file d’attente, consultez notifications de file d’attente.

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