À 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 relatives à la notification actuelle dans un ensemble de paramètres, Param1 et Param2.

Par exemple, si la file d’attente envoie une notification de SPFILENOTIFY_NEEDMEDIA à la routine de rappel par défaut, Param1 pointe vers une structure de SOURCE_MEDIA qui contient des informations sur le média nécessaire, et Param2 pointe vers un tableau de caractères qui peut recevoir de nouvelles informations de chemin d’accès de 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 en cours. 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, en fonction de 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.