Création d’une routine de rappel de file d’attente personnalisée

En plus d’utiliser le rappel de file d’attente par défaut, vous pouvez écrire une routine de rappel personnalisée. Cette fonction doit avoir le même formulaire que FileCallback. Cela est utile si vous avez besoin d’une routine de rappel pour gérer une notification d’une autre manière que celle fournie par la routine de rappel de la file d’attente par défaut.

Si seule une petite partie du comportement de la routine de rappel de file d’attente par défaut doit être modifiée, vous pouvez créer une routine de rappel personnalisée pour filtrer les notifications, en gérant uniquement celles qui nécessitent un comportement spécial et en appelant SetupDefaultQueueCallback pour les autres.

Par exemple, si vous souhaitez gérer les erreurs de suppression de fichiers personnalisées, vous pouvez créer une fonction de rappel personnalisée, MyCallback. Cette fonction intercepte et traite SPFILENOTIFY_DELETEERROR notifications et appelle la fonction de rappel de file d’attente par défaut pour toutes les autres notifications. MyCallback retourne une valeur pour les notifications d’erreur de suppression. Pour toutes les autres notifications, MyCallback transmet la valeur que la routine de rappel de file d’attente par défaut a retournée à la file d’attente.

Ce flux de contrôle est illustré dans le diagramme suivant.

Important

Si la fonction de rappel personnalisée appelle la routine de rappel de file d’attente par défaut, elle doit passer le pointeur void retourné par SetupInitDefaultQueueCallback ou SetupInitDefaultQueueCallbackEx à la routine de rappel par défaut.